Sign in

v1

latestOpenAPI 3.0.02026-08-04109109370.6 KB
Contacts (People)

Create a contact

Create a new contact, also known as a person, in Nutshell. Only one contact may be created at a time.

post/contacts

Request body

Example request

{
  "contacts": [
    {
      "phones": [
        {
          "isOptedOut": true,
          "isPrimary": true,
          "name": "phone",
          "value": {
            "countryCode": "1",
            "number": "7341234567",
            "extension": "123",
            "numberFormatted": "734-123-4567",
            "E164": "+17341234567",
            "countryCodeAndNumber": "+1 734-123-4567"
          }
        }
      ],
      "emails": [
        {
          "isPrimary": true,
          "name": "personal",
          "value": "andy@nutshell.com"
        }
      ],
      "urls": [
        {
          "isPrimary": true,
          "name": "LinkedIn",
          "value": "https://www.linkedin.com"
        }
      ],
      "addresses": [
        {
          "isPrimary": true,
          "name": "address",
          "value": {
            "location": {
              "longitude": -83.732124,
              "latitude": 42.279594
            }
          },
          "locationAccuracy": "8",
          "address_1": "206 E Huron St",
          "address_2": "Suite 200",
          "city": "Ann Arbor",
          "state": "MI",
          "postalCode": "48103",
          "country": "US"
        }
      ],
      "customFields": {
        "Favorite Number": "12"
      }
    }
  ]
}

Response

Contact

linksobject

Where to get related entities.

Example response

{
  "contacts": [
    {
      "id": "3-contacts",
      "name": "Andy Nutshell",
      "description": "CEO / cofounder @ Nutshell. Building growth software, wrangling beagles 🐶",
      "emails": [
        {
          "isPrimary": true,
          "name": "personal",
          "value": "andy@nutshell.com"
        }
      ],
      "addresses": [
        {
          "isPrimary": true,
          "name": "address",
          "value": {
            "location": {
              "longitude": -83.732124,
              "latitude": 42.279594
            }
          },
          "locationAccuracy": "8",
          "address_1": "206 E Huron St",
          "address_2": "Suite 200",
          "city": "Ann Arbor",
          "state": "MI",
          "postalCode": "48103",
          "country": "US"
        }
      ],
      "phones": [
        {
          "isOptedOut": true,
          "isPrimary": true,
          "name": "phone",
          "value": {
            "countryCode": "1",
            "number": "7341234567",
            "extension": "123",
            "numberFormatted": "734-123-4567",
            "E164": "+17341234567",
            "countryCodeAndNumber": "+1 734-123-4567"
          }
        }
      ],
      "urls": [
        {
          "isPrimary": true,
          "name": "LinkedIn",
          "value": "https://www.linkedin.com"
        }
      ],
      "avatarUrl": "https://app.nutshell.com/avatars/contacts/1006/{path}",
      "initials": "AF",
      "htmlUrl": "https://app.nutshell.com/lead/1006",
      "htmlUrlPath": "/lead/1006",
      "jobTitle": "CEO",
      "firstName": "Andy",
      "lastName": "Fowler",
      "href": "https://app.nutshell.com/rest/contacts/3-contacts"
    }
  ]
}