Update a contact

Change what is known about a contact, set interest, or move them on the pipeline board. Only the fields you send change; null clears a text field. A new email, LinkedIn URL or company domain is checked against suppression, as a new contact is, and refused when it is blocked or another contact in the workspace already has it. A contact always keeps an email or a LinkedIn URL.

PATCHhttps://app.trygtm.com/api/v1/contacts/{contact_id}

Scope: write
MCP tool: update_contact

Path parameters

contact_idstringrequired: The contact's id.

Headers

Idempotency-Keystringoptional: A key unique to this write, up to 255 characters. A retry carrying the same key returns the first response instead of running again. Kept for 24 hours.

Body

emailstring | nulloptional: Email address. Checked against suppression before it is saved.
linkedin_urlstring | nulloptional: LinkedIn profile URL. Checked against suppression before it is saved.
first_namestring | nulloptional: Given name.
last_namestring | nulloptional: Family name.
full_namestring | nulloptional: Display name.
titlestring | nulloptional: Job title.
phonestring | nulloptional: Phone number.
company_namestring | nulloptional: Employer.
company_domainstring | nulloptional: Employer's web domain.
industrystring | nulloptional: Industry label.
company_sizestring | nulloptional: Headcount band.
locationstring | nulloptional: City or region.
countrystring | nulloptional: Country name or ISO alpha-2 code.
notesstring | nulloptional: Free-text notes.
intereststringoptional: Your read of their interest.interestedmaybenot_interestedunknown
pipeline_stagestringoptional: The inbox board column to move them to.unansweredwaiting_connectionconnectedfirst_touchfollow_upinterestedbookedlost

Request

curl -X PATCH https://app.trygtm.com/api/v1/contacts/8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10 \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "dana@northbeam.example",
    "first_name": "Dana"
  }'

Response

{
  "data": {
    "id": "8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10",
    "first_name": "Dana",
    "last_name": "Whitfield",
    "full_name": "Dana Whitfield",
    "email": "dana@northbeam.example",
    "phone": null,
    "title": "VP Demand Generation",
    "company_name": "Northbeam Logistics",
    "company_domain": "northbeam.example",
    "country": "US",
    "status": "queued",
    "interest": "interested",
    "fit_score": 4,
    "intent_evidence_at": "2026-09-12T14:02:11.000Z",
    "linkedin_url": "https://www.linkedin.com/in/example",
    "pipeline_stage": "interested",
    "created_at": "2026-09-02T09:41:02.000Z"
  }
}