Create a new contact | Close | Developer API Documentation

curl -X POST https://api.close.com/api/v1/contact/ \
     -H "Content-Type: application/json" \
     -u "<CLOSE_API_KEY>:" \
     -d '{
  "custom.cf_j0P7kHmgFTZZnYBFtyPSZ3uQw4dpW8xKcW7Krps8atj": "Account Executive",
  "emails": [
    {
      "email": "john@example.com",
      "type": "office"
    }
  ],
  "lead_id": "lead_QyNaWw4fdSwxl5Mc5daMFf3Y27PpIcH0awPbC9l7uyo",
  "name": "John Smith",
  "phones": [
    {
      "phone": "9045551234",
      "type": "mobile"
    }
  ],
  "title": "President",
  "urls": [
    {
      "type": "url",
      "url": "http://twitter.com/google/"
    }
  ]
}'

{
  "created_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
  "date_created": "2013-03-07T23:23:21.495000+00:00",
  "date_updated": "2013-03-07T23:23:21.495000+00:00",
  "display_name": "John Smith",
  "id": "cont_sNIdBgngvbdTTEN1mspKgUqKAWfbul4IITvnWoRw1T7",
  "name": "John Smith",
  "organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
  "title": "President",
  "updated_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
  "emails": [
    {
      "email": "john@example.com",
      "is_unsubscribed": false,
      "type": "office"
    }
  ],
  "phones": [
    {
      "phone": "+19045551234",
      "type": "mobile",
      "country": "US",
      "phone_formatted": "+1 904-555-1234"
    }
  ],
  "urls": [
    {
      "type": "url",
      "url": "http://twitter.com/google/"
    }
  ],
  "custom.cf_j0P7kHmgFTZZnYBFtyPSZ3uQw4dpW8xKcW7Krps8atj": "Account Executive"
}

Contacts belong to exactly one Lead (specified by lead_id). If you do not provide a lead_id then a new lead will be created, named after the contact.

Authentication

AuthorizationBasic

Use your API key as the username and leave the password empty.

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

_fieldsstringOptional

Comma-separated list of fields to include in the response.

Request

This endpoint expects any.

Response

Successful response

created_bystring or null

date_createddatetime

date_updateddatetime

display_namestring

idstring

namestring or null

organization_idstring

titlestring or null

updated_bystring or null

emailslist of objects

integration_linkslist of objects

lead_idstring or null

lead_suggestions_operation_idstring or null

phoneslist of objects

recent_callslist of objects

subscriptionslist of objects

timezonestring or null

timezone_sourcestring or null

urlslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error