Contacts¶
Contacts are natural or legal persons known to your organization. This API endpoint enables CRUD operations on Contacts. The Contacts list is the organization directory.
Contacts collection¶
GET¶
Retrieve list of contacts of a specific organization.
GET /orgs/{org_pk}/contacts/
Parameters
expand:
notes(enum[string], optional)Include full notes inside of the contact body.
Example request:
curl -iL --request GET "https:/www.readycloud.com/api/v2/orgs/1/contacts/?bearer_token=4ef5b29b1f4f35c383bebfccf4bf4d01"
Response 200 (application/json):
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"addresses": [
{
"address_type": "shipping",
"address_1": "2010 Warsaw Rd",
"address_2": "Apt 4",
"city": "Roswell",
"company": "FedEx",
"country": "United States",
"default": true,
"email": "[email protected]",
"first_name": "Nick",
"last_name": "Smith",
"phone": "6785851113",
"post_code": "56001",
"region": "NY",
"residential": false,
"url": "/api/v2/orgs/1/contacts/5/addresses/5/",
"validated": false
}
],
"created_at": "2018-03-30T00:00:16.159321Z",
"custom_fields": {},
"description": null,
"first_name": "Nick",
"is_company": false,
"last_name": "Smith",
"notes": [],
"occupation": null,
"orders": "/api/v2/orgs/1/contacts/5/orders/",
"profile_image": null,
"source": {
"retrieved_at": "2018-03-30T00:00:16+00:00"
},
"updated_at": "2018-03-30T00:00:16.159321Z",
"url": "/api/v2/orgs/1/contacts/5/",
"website": null
}
]
}
POST¶
Create new contact for a specific organization.
POST /orgs/{org_pk}/contacts/
Example request:
curl -iL --request POST -H "Content-Type: application/json" --upload-file data.json "https:/www.readycloud.com/api/v2/orgs/1/contacts/?bearer_token=4ef5b29b1f4f35c383bebfccf4bf4d01"
data.json:
{
"first_name": "Marge",
"last_name": "Simpson",
"profile_image": null,
"occupation": null,
"orders": [],
"notes": [],
"website": null,
"description": null,
"is_company": false,
"addresses": [
{
"address_type": "shipping",
"company": "ReadyCloud",
"first_name": "Marge",
"last_name": "Simpson",
"address_1": "4032 N Scottsdale Rd",
"address_2": "",
"city": "Scottsdale",
"region": "AZ",
"post_code": "85251",
"country": "United States",
"phone": " +1 555-321-4578",
"email": "[email protected]",
"residential": null,
"validated": false,
"default": true
}
],
"custom_fields": {}
}
Response 201 (application/json):
{
"addresses": [
{
"address_type": "shipping",
"address_1": "4032 N Scottsdale Rd",
"address_2": "",
"city": "Scottsdale",
"company": "ReadyCloud",
"country": "United States",
"default": true,
"email": "[email protected]",
"first_name": "Marge",
"last_name": "Simpson",
"phone": "+1 555-321-4578",
"post_code": "85251",
"region": "AZ",
"residential": null,
"url": "/api/v2/orgs/1/contacts/6/addresses/6/",
"validated": false
}
],
"created_at": "2018-03-30T00:00:16.159321Z",
"custom_fields": {},
"description": null,
"first_name": "Marge",
"is_company": false,
"last_name": "Simpson",
"notes": [],
"occupation": null,
"orders": "/api/v2/orgs/1/contacts/6/orders/",
"profile_image": null,
"updated_at": "2018-03-30T00:00:16.159321Z",
"source": {
"account": null,
"channel": null,
"id": null,
"name": null,
"retrieved_at": "2018-03-30T00:00:16.159321Z",
"updated_at": "2018-03-30T00:00:16.159321Z"
},
"url": "/api/v2/orgs/1/contacts/6/",
"website": null
}
Contact¶
GET¶
Retrieve details of a specific contact.
GET /orgs/{org_pk}/contacts/{contact_pk}/
Parameters
expand:
notes(enum[string], optional)Include full notes inside of the contact body.
Example request:
curl -iL --request GET "https:/www.readycloud.com/api/v2/orgs/1/contacts/1/?bearer_token=4ef5b29b1f4f35c383bebfccf4bf4d01"
Response 200 (application/json):
{
"addresses": [
{
"address_type": "shipping",
"address_1": "2010 Warsaw Rd",
"address_2": "Apt 4",
"city": "Roswell",
"company": "FedEx",
"country": "United States",
"default": true,
"email": "[email protected]",
"first_name": "Nick",
"last_name": "Smith",
"phone": "6785851113",
"post_code": "56001",
"region": "NY",
"residential": false,
"url": "/api/v2/orgs/1/contacts/5/addresses/5/",
"validated": false
}
],
"created_at": "2018-03-30T00:00:16.159321Z",
"custom_fields": {},
"description": null,
"first_name": "Nick",
"is_company": false,
"last_name": "Smith",
"notes": [],
"occupation": null,
"orders": "/api/v2/orgs/1/contacts/5/orders/",
"profile_image": null,
"source": {
"retrieved_at": "2018-03-30T00:00:16+00:00"
},
"updated_at": "2018-03-30T00:00:16.159321Z",
"url": "/api/v2/orgs/1/contacts/5/",
"website": null
}
PATCH¶
Update a specific contact.
PATCH /orgs/{org_pk}/contacts/{contact_pk}/
Example request:
curl -iL --request PATCH -H "Content-Type: application/json" --upload-file data.json "https:/www.readycloud.com/api/v2/orgs/1/contacts/1/?bearer_token=4ef5b29b1f4f35c383bebfccf4bf4d01"
data.json:
{
"addresses": [
{
"address_type": "shipping",
"company": "self-employed",
"email": "[email protected]",
"url": "/api/v2/orgs/1/contacts/5/addresses/5/"
}
],
"website": "http://www.nicksmith.com/"
}
Response 200 (application/json):
{
"addresses": [
{
"address_type": "shipping",
"address_1": "2010 Warsaw Rd",
"address_2": "Apt 4",
"city": "Roswell",
"company": "self-employed",
"country": "United States",
"default": true,
"email": "[email protected]",
"first_name": "Nick",
"last_name": "Smith",
"phone": "6785851113",
"post_code": "56001",
"region": "NY",
"residential": false,
"url": "/api/v2/orgs/1/contacts/5/addresses/5/",
"validated": false
}
],
"created_at": "2018-03-30T00:00:16.159321Z",
"custom_fields": {},
"description": null,
"first_name": "Nick",
"is_company": false,
"last_name": "Smith",
"notes": [],
"occupation": null,
"orders": "/api/v2/orgs/1/contacts/5/orders/",
"profile_image": null,
"source": {
"account": null,
"channel": null,
"id": null,
"name": null,
"retrieved_at": "2018-03-30T00:00:16.159321Z",
"updated_at": "2018-03-30T00:00:16.159321Z"
},
"updated_at": "2018-03-30T00:00:16.159321Z",
"url": "/api/v2/orgs/1/contacts/5/",
"website": "http://www.nicksmith.com/"
}
DELETE¶
Delete a specific contact.
DELETE /orgs/{org_pk}/contacts/{contact_pk}/
Response 204 (application/json)