Create a contact

Add one person directly, bypassing sourcing. Needs an email or a LinkedIn URL. The address is checked against suppression before the row is written, and the person is deduplicated inside the workspace. This creates a row; it sends nothing and spends nothing.

POSThttps://app.trygtm.com/api/v1/contacts

Scope: write
MCP tool: create_contact

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: Work or personal address. Lowercased and deduplicated on.
linkedin_urlstring | nulloptional: LinkedIn profile URL. The key sourced contacts dedupe on.
first_namestring | nulloptional: Given name.
last_namestring | nulloptional: Family name.
full_namestring | nulloptional: Display name. Built from first and last name when omitted.
titlestring | nulloptional: Job title.
phonestring | nulloptional: Phone number. Stored in E.164 when it parses, as written when not.
company_namestring | nulloptional: Employer.
company_domainstring | nulloptional: Employer's web domain. Lets suppression match at company scope.
company_urlstring | nulloptional: Employer's website.
industrystring | nulloptional: Industry label.
company_sizestring | nulloptional: Headcount band, as free text.
locationstring | nulloptional: City or region.
countrystring | nulloptional: Country name or ISO 3166-1 alpha-2 code. Stored as the code. The send window uses it to run on the recipient's clock.
notesstring | nulloptional: Free-text notes shown on the contact.
list_idstring | nulloptional: Optional existing static list ID from list_lists. Use null when absent; never invent an ID.

Request

curl -X POST https://app.trygtm.com/api/v1/contacts \
  -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": "unknown",
    "fit_score": 4,
    "intent_evidence_at": "2026-09-12T14:02:11.000Z",
    "linkedin_url": "https://www.linkedin.com/in/example",
    "pipeline_stage": null,
    "created_at": "2026-09-02T09:41:02.000Z"
  }
}