Create a list
Create an empty static list. A name already in use answers 409 with the existing list's id.
POST
https://app.trygtm.com/api/v1/lists- Scope
write- MCP tool
- create_list
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
namestringrequired- The list's name. Name it after the ICP it holds.
descriptionstringoptional- What the list is for.
Request
curl -X POST https://app.trygtm.com/api/v1/lists \
-H "Authorization: Bearer $TRYGTM_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"name": "Q4 logistics leaders"
}'Response
{
"data": {
"id": "5e6f7a8b-1c2d-4e3f-9a0b-1c2d3e4f5a6b",
"name": "Trade show — Sept",
"description": null,
"kind": "static",
"member_count": 0,
"created_at": "2026-09-18T10:00:00.000Z",
"updated_at": "2026-09-18T10:00:00.000Z"
}
}