Sign in
Contacts

Update a contact

Updates the given fields of a contact. Omitted fields are left untouched; sending null clears the field.

Tags are linked by id or name and must already exist in the workspace — unknown tags are ignored. Use PATCH /contacts/{contactId}/tags to create tags on demand.

patch/contacts/{contactId}

Path parameters

contactIdstring uuid required

Request body

firstNamestring nullable
lastNamestring nullable
emailstring nullable
phonestring nullable
occupationstring nullable
genderstring nullable
birthdatestring nullable
agenumber nullable
notesstring nullable
customPropertiesobject

Values for the custom contact properties of the workspace, keyed by property name

Response

Contact updated successfully

Changes

Changed in 3 of the 9 revisions of this API.6114

  • 54db63e3ad481See the full diff
    • ▲

      added the new path request parameter contactId

      new-request-path-parameter

  • 8ccfb9a461e25113See the full diff
    • ▲

      request body became required

      request-body-became-required

    • ▲

      request property age list-of-types was narrowed by removing types integer from media type application/json

      request-property-list-of-types-narrowed

    • ▲

      added 'propertyNames' constraint to the request property customProperties

      request-property-property-names-added

    • ▲

      removed the media type application/json for the response with the status 404

      response-media-type-removed

    • ▲

      removed the success response with the status 200

      response-success-status-removed

    • ●

      deleted the path request parameter contactId

      request-parameter-removed

    • ○

      added the new optional request property tags

      new-optional-request-property

    • ○

      request property birthdate list-of-types was widened by adding types null to media type application/json

      request-property-list-of-types-widened

    • ○

      request property customProperties/additionalProperties/ list-of-types was widened by adding types number to media type application/json

      request-property-list-of-types-widened

    • ○

      request property email list-of-types was widened by adding types null to media type application/json

      request-property-list-of-types-widened

    • ○

      request property firstName list-of-types was widened by adding types null to media type application/json

      request-property-list-of-types-widened

    • ○

      request property gender list-of-types was widened by adding types null to media type application/json

      request-property-list-of-types-widened

    • ○

      request property lastName list-of-types was widened by adding types null to media type application/json

      request-property-list-of-types-widened

    • ○

      request property notes list-of-types was widened by adding types null to media type application/json

      request-property-list-of-types-widened

    • ○

      request property occupation list-of-types was widened by adding types null to media type application/json

      request-property-list-of-types-widened

    • ○

      request property phone list-of-types was widened by adding types null to media type application/json

      request-property-list-of-types-widened

    • ○

      added the non-success response with the status 400

      response-non-success-status-added

    • ○

      added the non-success response with the status 401

      response-non-success-status-added

    • ○

      added the success response with the status 204

      response-success-status-added

  • e21feba47bec1See the full diff
    • ○

      added the new optional request property customProperties

      new-optional-request-property