Save an ICP

Create an ICP, or update one by sending its id. Omitted fields stay unchanged. Use real targeting phrases, never vendor filter ids.

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

Scope: write
MCP tool: save_icp

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

idstring | nulloptional: An existing ICP's UUID from list_icps, to update it. Omit or use null to create one, or to let the tool find the existing one. Never invent or guess an ID.
namestringrequired: The ICP's name.
descriptionstringoptional: Who this is, in a sentence or two. The lead judge reads it.
job_titlesstring[]optional: Job titles to target, e.g. VP Marketing. Real phrases, up to 100. Omit to leave unchanged.
industriesstring[]optional: Industries to target. Real phrases, up to 100. Omit to leave unchanged.
company_sizesstring[]optional: Headcount bands, e.g. 51-200. Real phrases, up to 100. Omit to leave unchanged.
locationsstring[]optional: Countries, states or cities. Real phrases, up to 100. Omit to leave unchanged.
company_typesstring[]optional: Kinds of company, e.g. SaaS, agency. Real phrases, up to 100. Omit to leave unchanged.
technologiesstring[]optional: Technologies the company uses. Real phrases, up to 100. Omit to leave unchanged.
exclusionsstring[]optional: Who to leave out: titles, industries or named companies. Real phrases, up to 100. Omit to leave unchanged.
matching_modestringoptional: How strictly candidates are judged against the profile. discovery is widest.discoverybalancedhigh_precision
is_defaultbooleanoptional: true makes this the workspace's default ICP, the one sourcing and the monitoring signals read; the previous default stops being the default. Omit to leave it as it is.
senioritiesstring[]optional: Seniority levels the prospect search filters on directly. Omit to leave unchanged.FounderOwnerC-LevelPartnerVPHeadDirectorManagerSeniorEntry

Request

curl -X POST https://app.trygtm.com/api/v1/icps \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q4 logistics leaders"
  }'

Response

{
  "data": {
    "id": "f0e1d2c3-b4a5-4697-8877-66554433aa11",
    "name": "Logistics demand leaders",
    "status": "saved"
  }
}