Set interest on many contacts

Set interest (interested, maybe, not_interested or unknown) on up to 5,000 contacts at once, as the Contacts screen's bulk bar does. For any other field, update one contact.

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

Scope: write
MCP tool: update_contacts

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

contact_idsstring[]required: Contact ids, up to 5,000 a call. Read them from list_contacts.
intereststringrequired: The interest to set on every one of them.interestedmaybenot_interestedunknown

Request

curl -X POST https://app.trygtm.com/api/v1/contacts/interest \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_ids": [
      "8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10"
    ],
    "interest": "interested"
  }'

Response

{
  "data": {
    "updated": 2,
    "interest": "interested"
  }
}