Skip to main content
PATCH
Update contact
Send the fields you want to change, such as a contact’s role or email address. Review the request fields below before updating a profile used by an active sequence. Ownership, contact IDs, internal workflow state, unknown fields, dotted property names and database update operators are rejected. Send profile values directly, and use dedicated pipeline, campaign and document endpoints for workflow changes. Rate limit: 30 requests/minute per endpoint and workgroup. Details.

Authorizations

x-api-key
string
header
required

Primary public authentication method. Create keys in Jobin.cloud under Workgroups > Integrations > Custom integration.

Path Parameters

contactId
string
required

Body

application/json

Partial contact update. Public aliases currentTitle, currentCompany, currentCompanyUrl, currentCompanySocialUrl, headline, managementLevel and seniority accept trimmed nonempty strings. location accepts a nonempty address string or an address object (address, addressLine2, city, country, countryCode, fullAddress, postalCode, region or state). Additional contact fields follow contact-update validation. Inspect appliedFields and ignoredFields in the response. At every level, strings are limited to 4000 characters, arrays to 100 items, objects to 100 keys, and keys to 1–128 characters.

currentTitle
string

Trimmed, nonempty public profile value.

Required string length: 1 - 4000
Pattern: \S
currentCompany
string

Trimmed, nonempty public profile value.

Required string length: 1 - 4000
Pattern: \S
currentCompanyUrl
string

Trimmed, nonempty public profile value.

Required string length: 1 - 4000
Pattern: \S
currentCompanySocialUrl
string

Trimmed, nonempty public profile value.

Required string length: 1 - 4000
Pattern: \S
headline
string

Trimmed, nonempty public profile value.

Required string length: 1 - 4000
Pattern: \S
managementLevel
string

Trimmed, nonempty public profile value.

Required string length: 1 - 4000
Pattern: \S
seniority
string

Trimmed, nonempty public profile value.

Required string length: 1 - 4000
Pattern: \S
location
Required string length: 1 - 4000
Pattern: \S
{key}

Response

Updated contact payload

modifiedCount
integer
contact
object

Integration-friendly contact representation used by the public OpenAPI surface.