Send a message as soon as possible

Release an unsent message for the launcher's next tick without changing its words: a draft is approved, a queued message has its wait cleared. It is still sent by the launcher, behind the send gate.

POSThttps://app.trygtm.com/api/v1/messages/{message_id}/release
Scope
write

Path parameters

message_idstringrequired
The unsent message's id.

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 POST https://app.trygtm.com/api/v1/messages/8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10/release \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

Response

{
  "data": {
    "id": "aa11bb22-cc33-4d44-8e55-ff6677889900",
    "conversation_id": "0f1e2d3c-4b5a-4697-8877-665544332211",
    "direction": "outbound",
    "channel": "email",
    "kind": "message",
    "status": "queued",
    "subject": "Re: routing software",
    "body": "Tuesday at 10 works. I'll send an invite.",
    "gate_result": null,
    "error": null,
    "scheduled_for": null,
    "created_at": "2026-09-18T10:15:00.000Z",
    "updated_at": "2026-09-18T10:16:00.000Z",
    "outcome": "Queued. The launcher sends it on its next tick, usually within a minute, after the suppression check and the send gate."
  }
}

Was this page helpful?