CLclose
contacts

Update an existing contact

Changed on

Update a contact's information. Custom field values can be set by including custom.cf_* keys in the request body, e.g. "custom.cf_abc123": "value".

For custom fields that accept multiple values, you can use .add or .remove suffixes to modify the existing list without replacing it:

{ "custom.cf_v6S011I6MqcbVvB2FA5Nk8dr5MkL8sWuCiG8cUleO9c.add": "Wednesday" }
put/contact/{id}/

Request

  • Base URL
    https://api.close.com/api/v1
  • URL
    https://api.close.com/api/v1/contact/{id}/
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://app.close.com/oauth2/authorize/
      Token URL: https://api.close.com/oauth2/token/

Path parameters

idstring required

Query parameters

_fieldsstring

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

Request body

lead_idstring nullable
namestring nullable
timezonestring nullable

IANA timezone identifier

titlestring nullable

Response

Successful response

created_bystring nullable required
created_by_agent_idstring nullable
date_createdstring date-time required
date_updatedstring date-time required
display_namestring required
idstring required
lead_idstring nullable
namestring nullable required
organization_idstring required
timezonestring nullable
timezone_sourcestring nullable
titlestring nullable required
updated_bystring nullable required
updated_by_agent_idstring nullable

Changes

  • 8e360c61058cRevision changes
    • info

      added the pattern property ^custom\.(cf|lcf|ccf|acf|gcf|scf)_[A-Za-z0-9]+$ to the response body for the status

  • 7bdb9cfcca22Revision changes
    • breaking

      added the pattern property ^custom\.(cf|lcf|ccf|acf|gcf|scf)_[A-Za-z0-9]+(\.(add|remove))?$ to the request body

    • info

      removed the pattern property ^custom\. from the request body