Export contacts

The Contacts screen's CSV export as JSON rows: the same columns, labels included. Pass contact_ids for a selection, or the table's filters for everyone matching, up to 5,000. limit caps the rows returned (500 by default), and truncated says when it stopped short.

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

Scope: read
MCP tool: export_contacts

Body

contact_idsstring[] | nulloptional: Export exactly these contacts, in this order. Omit to export by filter.
searchstring | nulloptional: Matches name, email, company or title, as the Contacts search box does.
statusstring | nulloptional: Outbound state.newresearchingqueuedcontactedrepliedmeeting_bookedbounceddisqualifiedsuppressedlost
intereststring | nulloptional: Your team's read of their interest.interestedmaybenot_interestedunknown
min_heatinteger | nulloptional: Only contacts whose intent heat (fit_score) is at least this.
agent_idstring | nulloptional: Only contacts this agent sourced (from list_agents).
list_idstring | nulloptional: Only members of this list (from list_lists).
label_idstring | nulloptional: Only contacts carrying this label (from list_labels).
industrystring | nulloptional: Industry contains this text.
locationstring | nulloptional: Location contains this text.
company_sizestring | nulloptional: Exact headcount band, as the contact holds it.
has_emailboolean | nulloptional: true: only with an email. false: only without.
has_phoneboolean | nulloptional: true: only with a phone. false: only without.
limitintegeroptionaldefault: 500: The most rows to hand back.

Request

curl -X POST https://app.trygtm.com/api/v1/contacts/export \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "active",
    "interest": "interested"
  }'

Response

{
  "data": {
    "matched": 1,
    "returned": 1,
    "truncated": false,
    "rows": [
      {
        "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",
        "status": "queued",
        "interest": "unknown",
        "fit_score": 4,
        "source_system": "prospect_database",
        "created_at": "2026-09-02T09:41:02.000Z",
        "labels": [
          "Warm"
        ]
      }
    ]
  }
}