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": "user@mail.com",
                    "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": "marge@readycloud.com",
            "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": "marge@readycloud.com",
            "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": "user@mail.com",
            "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": "boss@nicksmith.com",
            "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": "boss@nicksmith.com",
            "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)