Update an existing contact | Close | Developer API Documentation

curl -X PUT https://api.close.com/api/v1/contact/id/ \
     -H "Content-Type: application/json" \
     -u "<CLOSE_API_KEY>:" \
     -d '{
  "name": "Johnny Smith"
}'

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

Update a contact’s information. If you’re trying to update a custom field and that custom field accepts multiple values, you can specify .add or .remove as part of the field key to add/remove a single value to/from a list of values, e.g.:

1 { "custom.cf_v6S011I6MqcbVvB2FA5Nk8dr5MkL8sWuCiG8cUleO9c.add": "Wednesday" }

adds “Wednesday” to the list of values which already exist on the given contact.

Update a contact's information. If you're trying to update a custom field and that custom field accepts multiple values, you can specify `.add` or `.remove` as part of the field key to add/remove a single value to/from a list of values, e.g.: ```json { "custom.cf_v6S011I6MqcbVvB2FA5Nk8dr5MkL8sWuCiG8cUleO9c.add": "Wednesday" } ``` adds "Wednesday" to the list of values which already exist on the given contact.

Authentication

AuthorizationBasic

Basic authentication of the form Basic <base64(username:)>.

AuthorizationBearer

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

Path parameters

idstringRequired

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