Update a contact - GainTrace

curl --request PATCH \ --url https://app.gaintrace.com/api/v1/contacts/{id} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "name": "<string>", "email": "[email protected]", "externalId": "<string>", "phone": "<string>", "role": "<string>", "isChampion": true, "linkedinUrl": "<string>", "avatarUrl": "<string>" } '

{ "data": { "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "name": "<string>", "email": "[email protected]", "externalId": "<string>", "phone": "<string>", "role": "<string>", "isChampion": true, "linkedinUrl": "<string>", "avatarUrl": "<string>", "lastSeenAt": "2023-11-07T05:31:56Z", "engagementScore": 123, "createdAt": "2023-11-07T05:31:56Z", "updatedAt": "2023-11-07T05:31:56Z" } }

Authorizations

Authorization

string

header

required

Bearer API key. Secret server keys start with gt_live_; client-safe browser keys start with gt_pub_ (write-only, origin-pinned). Create and scope keys in Settings → API Keys.

Path Parameters

string

required

Resource UUID. For companies you may also pass ext:<externalId> to address by your external id.

Body

application/json

Any subset of the mutable contact fields.

name

string

Required string length: 1 - 255

string<email> | null

Unique per workspace.

Maximum string length: 255

externalId

string | null

Maximum string length: 255

phone

string | null

Maximum string length: 50

role

string | null

Maximum string length: 100

contactRole

enum<string>

Available options:

decision_maker,

champion,

end_user,

billing,

influencer,

executive_sponsor,

technical,

other

isChampion

boolean

linkedinUrl

string | null

Maximum string length: 2000

avatarUrl

string | null

Maximum string length: 2000

Response

The updated contact.

data

object

Show child attributes