Update a contact

Updates an existing contact. Send only the fields you want to change; any field you omit keeps its current value. <Tip> A contact's `type` is set at creation and cannot be updated. To change it, delete the contact and create a new one. </Tip>

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the /api/v1/authenticate POST request.

Path parameters

org_iddoubleRequired
Unique numeric ID of the organization the contact belongs to.
contact_iddoubleRequired

Unique numeric ID of the contact. This is the id returned by the List organization contacts endpoint.

Request

This endpoint expects an object.
namestringOptional
First and last name of the contact.
titlestringOptional

Honorific or professional title of the contact, for example Dr or Ing.

departmentstringOptional
Department the contact belongs to.
streetstringOptional
Street name and number of the contact's address.
zipcodestringOptional
Postal or ZIP code of the contact's address.
citystringOptional
City of the contact's address.
countryobjectOptional
Contact's country, provided as an object containing the country ID.
emailstringOptionalformat: "email"
Email address of the contact.
phonestringOptional
Phone number of the contact.
mobilestringOptional
Mobile phone number of the contact.
statestringOptional
State or province of the contact's address.
secondary_addressstringOptional
Secondary address line, for example apartment or building number.
purchase_order_numberstringOptional<=50 characters
Purchase order number shown on the organization's monthly invoices. <Tip> Set `purchase_order_number` only on invoice contacts (type `6`). When set, it appears on the organization's monthly invoices. </Tip>

Response

The contact was updated successfully. No content is returned.

Errors

404
Not Found Error