Delete a list

Delete a list. Its contacts stay in the workspace. Campaigns drawing from it stop taking new people from it, steps already queued are not cancelled, and routing rules that sent contacts to it are deleted. Answers 409 while a campaign build is still filling it.

DELETEhttps://app.trygtm.com/api/v1/lists/{list_id}

Scope: write
MCP tool: delete_list

Path parameters

list_idstringrequired: The list's id, from list_lists.

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.

Request

curl -X DELETE https://app.trygtm.com/api/v1/lists/8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10 \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

Response

{
  "data": {
    "deleted": {
      "id": "5e6f7a8b-1c2d-4e3f-9a0b-1c2d3e4f5a6b",
      "name": "Trade show — Sept"
    },
    "members_removed": 412,
    "campaigns_affected": [
      {
        "id": "3b7f0c52-91aa-4e0d-8c11-5a2d6e4f7b90",
        "name": "Q4 logistics leaders",
        "status": "active",
        "other_lists": 1
      }
    ],
    "agents_stopped": [],
    "routing_rules_deleted": []
  }
}