Link Search Menu Expand Document

Updated Fri Jun 18th 2021, 16:17 UTC

Create Contact

POST /:account/contacts

Create a new contact

Examples

Creating the contact

Request

POST /my_account/contacts

Body

{
  "name": "Cordell Walker",
  "phones": [
    {
      "number": "1-720-333-1234",
      "type": "Mobile"
    },
    {
      "number": "1-720-333-1235",
      "type": "Mobile"
    },
    {
      "number": "1-303-123-4567 x2921",
      "type": "Work"
    }
  ],
  "data": {
    "businessName": "McDonalds",
    "tags": ["cashier", "burger flipper", "fry cook"]
  }
}
Example
$ curl -i -H Accept:"application/vnd.textus+jsonld" \
    -H Authorization:"Bearer {token}" \
    -X POST /my_account/contacts
     -d '{json: "body"}' 

Response

Status

200

Response Type

Contact

Example
{
  "@type": "Contact",
  "id": "/contacts/DQeeO69",
  "@context": "/contexts/Contact.jsonld",
  "name": "Cordell Walker",
  "firstName": "Cordell",
  "lastName": "Walker",
  "phones": {
    "@type": "hydra:Collection",
    "id": "/contacts/DQeeO69/phones",
    "@context": "/contexts/hydra:Collection.jsonld",
    "totalItems": 3,
    "members": [
      {
        "@type": "ContactPhone",
        "id": "/contact_phones/mxvbRw",
        "@context": "/contexts/ContactPhone.jsonld",
        "phoneNumber": "+13035551234",
        "formattedPhoneNumber": "(303) 555-1234",
        "extension": null,
        "type": "Mobile",
        "deliverabilityStatus": "unknown",
        "contact": "/contacts/DQeeO69"
      },
      {
        "@type": "ContactPhone",
        "id": "/contact_phones/mxvbRw",
        "@context": "/contexts/ContactPhone.jsonld",
        "phoneNumber": "+13035551234",
        "formattedPhoneNumber": "(303) 555-1234",
        "extension": "2921",
        "type": "Mobile",
        "deliverabilityStatus": "unknown",
        "contact": "/contacts/DQeeO69"
      }
    ]
  },
  "notes": {
    "@type": "hydra:Collection",
    "id": "/contacts/DQeeO69/notes",
    "@context": "/contexts/hydra:Collection.jsonld",
    "totalItems": 0,
    "members": []
  },
  "data": {
    "businessName": "McDonalds",
    "tags": [
      "cashier",
      "burger flipper",
      "fry cook"
    ]
  },
  "conversations": "/contacts/DQeeO69/conversations",
  "createdAt": "2020-01-06T21:49:58.312Z"
}

© 2021 TextUs