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,
    "lastContactedAt": "2023-11-07T05:31:56Z",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "smartFieldExplanations": {}
  }
}

Contacts

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.

Required scope: CONTACTS_WRITE

Rate 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.

PATCH

contact

{contactId}

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,
    "lastContactedAt": "2023-11-07T05:31:56Z",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "smartFieldExplanations": {}
  }
}

Authorizations

x-api-key

string

header

required

Path Parameters

contactId

string

required

The contact ID

Body

application/json

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.

{key}

any

Response

Contact updated successfully

status

enum<string>

required

Available options:

success

message

string

required

data

object

required

Show child attributes

Delete a contact Create a new contact

API documentation

Endpoints

Update contact fields

Authorizations

Path Parameters

Body

Response