curl --request PATCH \
--url https://openapi.enginy.ai/v1/contact/{contactId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"firstName": "Ada",
"lastName": "Lovelace",
"jobTitle": "CTO",
"linkedInProfileUrl": "https://www.linkedin.com/in/adalovelace",
"contactCountry": "United States"
}
'{
"status": "success",
"message": "<string>",
"data": {
"id": 123,
"appUrl": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"jobTitle": "<string>",
"jobFunction": "<string>",
"jobLevel": "<string>",
"linkedInProfileUrl": "<string>",
"professionalEmail": "<string>",
"personalEmails": "<string>",
"mobilePhone": "<string>",
"phones": "<string>",
"imageUrl": "<string>",
"companyId": 123,
"company": {
"id": 123,
"appUrl": "<string>",
"name": "<string>",
"domain": "<string>",
"companyLinkedInUrl": "<string>"
},
"emailVerificationStatus": "<string>",
"contactCountry": "<string>",
"linkedInHeadline": "<string>",
"numberOfConnections": 123,
"contactCRMId": "<string>",
"leadCRMId": "<string>",
"isInCRM": true,
"tags": [
{
"id": 123,
"name": "<string>",
"color": "<string>"
}
],
"lastContactedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"smartFieldExplanations": {}
}
}Update contact fields
Update contact fields (standard and custom/AI fields by name). You can also set companyId to associate the contact with an existing company, or null to clear the current association. The contact’s own country is stored as leadCountry; responses expose it as contactCountry, and contactCountry is also accepted here as a write alias for leadCountry. linkedInProfileId accepts either the bare LinkedIn profile id or a URL: a LinkedIn profile URL is converted to its id automatically, and a URL with no extractable id (e.g. a vanity /in/<slug> URL, or a non-LinkedIn link) is rejected as an invalid value (400) rather than stored as given. Surrounding whitespace is trimmed.
Required scope:
CONTACTS_WRITERate limit: 30 requests per minute
Accepted standard fields (auto-updated):
- linkedInProfileId
- firstName
- jobTitle
- lastName
- linkedinProfileUrl
- personalEmails
- phones
- professionalEmail
- mobilePhone
- geoRegion
- leadCountry
- profileBio
- yearsInCompany
- yearsInRole
- lastLinkedInPost
- jobChange
- mentionedInNews
- promotion
- leadCRMId
- previousPositions
- languages
- linkedInHeadline
- companyId (special association field; use an existing company ID or null)
Custom/AI fields are also allowed by name and are client-specific.
curl --request PATCH \
--url https://openapi.enginy.ai/v1/contact/{contactId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"firstName": "Ada",
"lastName": "Lovelace",
"jobTitle": "CTO",
"linkedInProfileUrl": "https://www.linkedin.com/in/adalovelace",
"contactCountry": "United States"
}
'{
"status": "success",
"message": "<string>",
"data": {
"id": 123,
"appUrl": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"jobTitle": "<string>",
"jobFunction": "<string>",
"jobLevel": "<string>",
"linkedInProfileUrl": "<string>",
"professionalEmail": "<string>",
"personalEmails": "<string>",
"mobilePhone": "<string>",
"phones": "<string>",
"imageUrl": "<string>",
"companyId": 123,
"company": {
"id": 123,
"appUrl": "<string>",
"name": "<string>",
"domain": "<string>",
"companyLinkedInUrl": "<string>"
},
"emailVerificationStatus": "<string>",
"contactCountry": "<string>",
"linkedInHeadline": "<string>",
"numberOfConnections": 123,
"contactCRMId": "<string>",
"leadCRMId": "<string>",
"isInCRM": true,
"tags": [
{
"id": 123,
"name": "<string>",
"color": "<string>"
}
],
"lastContactedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"smartFieldExplanations": {}
}
}Authorizations
Path Parameters
The contact ID
Body
Fields to update on the contact. Supports standard and custom/AI fields by name. Use GET /v1/contacts/fields (MCP tool get_contact_field_metadata) to discover valid contact field names for fields, include, exclude, and update payloads.