Skip to content

Update a contact​

PUT
/api/nova/contacts/{contactId}

Updates an existing contact identified by its ID. This is a partial update: only the fields supplied in the request body overwrite the current values, and omitted fields are left unchanged. Supported fields match the create endpoint, including name, contact details, companyId, secondaryCompanyId, ownerId, tags, social links, dateOfBirth, description, internalNotes, skills, statusId, sourceId and customFields. Returns 404 if the contact does not exist, otherwise the response contains the updated contact's ID.

Authorizations​

privateApiKey
Type
API Key (query: apiKey)

Parameters​

Path Parameters

contactId*

contactId

Type
string
Required

Query Parameters

apiKey*

apiKey

Type
string
Required

Request Body​

application/json
JSON
{
  
"alternateEmail": "string",
  
"companyId": "string",
  
"customFields": [
  
  
{
  
  
  
"boolValue": "string",
  
  
  
"dateValue": "string",
  
  
  
"fieldId": "string",
  
  
  
"fieldLabel": "string",
  
  
  
"listValue": [
  
  
  
  
"string"
  
  
  
],
  
  
  
"value": "string"
  
  
}
  
],
  
"dateOfBirth": "string",
  
"description": "string",
  
"email": "string",
  
"facebook": "string",
  
"firstName": "string",
  
"homePhone": "string",
  
"id": "string",
  
"internalNotes": "string",
  
"jobTitle": "string",
  
"lastName": "string",
  
"linkedIn": "string",
  
"mobile": "string",
  
"ownerId": "string",
  
"secondaryCompanyId": "string",
  
"skills": [
  
  
"string"
  
],
  
"skype": "string",
  
"sourceId": "string",
  
"statusId": "string",
  
"tags": [
  
  
{
  
  
  
"group": "string",
  
  
  
"value": "string"
  
  
}
  
],
  
"twitter": "string",
  
"workPhone": "string"
}

Responses​

OK

application/json
JSON
{
  
"data": "string",
  
"error": "string",
  
"message": "string",
  
"requestId": "string",
  
"success": true
}

Playground​

Authorization
Variables
Key
Value
Body

Samples​

Recruitly — Recruitment CRM for Agencies