CONTACT

Updates an existing contact.

PUT/api/v2/contacts/{contactId}

Authentication

Choose one supported method for this request.

OAuth 2.0 client credentialsAPI key

Parameters

contactIdpathinteger · int32required

The contact ID to update.

Request body

application/jsonrequired

The updated contact details.

contactIdinteger · int32
companyIdinteger · int32
titlestring
positionstring
departmentstring
firstNamestring
middleNamestring
lastNamestring
nickNamestring
emailstring
phonestring
cellstring
faxstring
globalUnsubscribeboolean

Responses

Contact updated successfully.

Standard response envelopeisSuccessmessageerrorsdata

Read the result from data. When isSuccess is false, errors lists what went wrong. Handling errors

contactIdinteger · int32
companyIdinteger · int32
companyDisplaystring
firstNamestring
middleNamestring
lastNamestring
fullNamestring
nickNamestring
phonestring
cellstring
faxstring
emailstring
titlestring
positionstring
departmentstring
deletedboolean
activeboolean
enteredstring · date-time
lastModifiedstring · date-time
completeboolean
externalIdstring
globalUnsubscribeboolean
linkedboolean
lastTouchUserstring
lastTouchDatestring · datenullable

REQUEST EXAMPLE

curl --request PUT \
  'https://apiv2.crmseries.com/api/v2/contacts/CONTACT_ID' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "contactId": 1024,
    "companyId": 1024,
    "title": "string",
    "position": "string",
    "department": "string",
    "firstName": "Jane",
    "middleName": "string",
    "lastName": "Doe",
    "nickName": "string",
    "email": "jane.doe@example.com",
    "phone": "555-0100",
    "cell": "555-0100",
    "fax": "555-0100",
    "assignedPhones": [
      {
        "description": "string",
        "phone": "555-0100",
        "phoneId": 1024
      }
    ],
    "assignedEmails": [
      {
        "description": "string",
        "email": "jane.doe@example.com",
        "emailId": 1024
      }
    ],
    "globalUnsubscribe": true
  }'

Replace the uppercase placeholders and sample values with your integration values.

RESPONSE · 200

{
  "isSuccess": true,
  "message": "",
  "data": {
    "contactId": 1024,
    "companyId": 1024,
    "companyDisplay": "string",
    "firstName": "Jane",
    "middleName": "string",
    "lastName": "Doe",
    "fullName": "Jane Doe",
    "nickName": "string",
    "phone": "555-0100",
    "cell": "555-0100",
    "fax": "555-0100",
    "email": "jane.doe@example.com",
    "title": "string",
    "position": "string",
    "department": "string",
    "deleted": false,
    "active": true,
    "entered": "2026-01-15T14:30:00Z",
    "lastModified": "2026-01-15T14:30:00Z",
    "complete": true,
    "externalId": "string",
    "globalUnsubscribe": true,
    "linked": true,
    "assignedPhones": [
      {
        "description": "string",
        "phone": "555-0100",
        "phoneId": 1024
      }
    ],
    "assignedEmails": [
      {
        "description": "string",
        "email": "jane.doe@example.com",
        "emailId": 1024
      }
    ],
    "lastTouchUser": "string",
    "lastTouchDate": "2026-01-15",
    "recordAccessRights": {
      "exists": true,
      "view": true,
      "edit": true,
      "delete": true,
      "addNote": true
    }
  },
  "errors": []
}