Update contact

PATCH/api/v1/updateContact

Update a contact

Supply exactly one of contactId or lookupEmail.

Permission

An OAuth access token with this scope. How to get a token

contacts:write
Create, update, and remove contacts.

Parameters

Not sure what to enter? Here’s where to find IDs.

client_idquery · stringrequired
The Client ID of your OAuth client. It’s public, and goes on every request alongside your access token. Find it in QuoteCloud under Settings → API dashboard → Manage Integrations → OAuth Clients.Length at least 1.

Request body

Sent as application/json.

contactIdstring
Length at least 1.
lookupEmailstring (email)
Length at least 1.
emailstring (email) or null
firstNamestring or null
lastNamestring or null
companystring or null
companyAccountRefstring or null
phonestring or null
mobilestring or null
jobTitlestring or null
addressstring or null
^customfield\d+$keys matching · any

Needs one of contactId, lookupEmail.

Responses

200Contact updated.
dataobjectrequired
Fields
statusstringrequired
Always success.
messagestringrequired
contactobjectrequired
Fields
idstringrequired
emailstring (email)required
firstNamestringrequired
lastNamestringrequired
fullNamestringrequired
phonestringrequired
mobilestringrequired
jobTitlestringrequired
addressstringrequired
companystring
companyAccountRefstring
createdAtvaries
Fields

Exactly one of these:

Option 1number
Option 2string (date-time)
updatedAtvariesrequired
Fields

Exactly one of these:

Option 1number
Option 2string (date-time)
400Invalid request or validation failure.
dataobjectrequired
Fields
statusstringrequired
Always error.
messagestringrequired
codestring
documentRefstring
assetGenerationIdstring
errorsarray of object
Item fields
fieldstringrequired
messagestringrequired
401Missing or invalid bearer token or client ID.
errorstringrequired
error_descriptionstring
403Insufficient scope, missing add-on, usage limit, or permission denial.

Exactly one of these:

OAuthError
errorstringrequired
error_descriptionstring
ApiErrorEnvelope
dataobjectrequired
Fields
statusstringrequired
Always error.
messagestringrequired
codestring
documentRefstring
assetGenerationIdstring
errorsarray of object
Item fields
fieldstringrequired
messagestringrequired
404Requested resource was not found in the token's company.
dataobjectrequired
Fields
statusstringrequired
Always error.
messagestringrequired
codestring
documentRefstring
assetGenerationIdstring
errorsarray of object
Item fields
fieldstringrequired
messagestringrequired
409Request conflicts with resource state or an idempotent request.
dataobjectrequired
Fields
statusstringrequired
Always error.
messagestringrequired
codestring
documentRefstring
assetGenerationIdstring
errorsarray of object
Item fields
fieldstringrequired
messagestringrequired
429Shared company API request quota exceeded. Wait before retrying.
Retry-Afterheader · integer
Minimum seconds to wait before retrying.Value at least 1.
dataobjectrequired
Fields
statusstringrequired
Always error.
messagestringrequired
retryAfterSecondsintegerrequired
Value at least 1.

Rate limit

120 requests a minute per company, shared across REST, Zapier and MCP. On a 429, wait for Retry-After.