Generate a reply draft

Have the copy agent write the next message on a thread and save it as a draft. Spends credits for one AI message. Never queues: read it, then send it with Update a message.

POSThttps://app.trygtm.com/api/v1/conversations/{conversation_id}/messages/generate

Scope: write
Cost: 2 action credits per unit — ai.message.standard
MCP tool: generate_reply_draft

Path parameters

conversation_idstringrequired: The thread to draft on.

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

instructionstringoptional: What the reply should do, e.g. 'offer Tuesday or Thursday'.

Request

curl -X POST https://app.trygtm.com/api/v1/conversations/8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10/messages/generate \
  -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": "drafted",
    "subject": "Re: routing software",
    "body": "Tuesday at 10 works. I'll send an invite.",
    "gate_result": null,
    "error": null,
    "created_at": "2026-09-18T10:15:00.000Z",
    "updated_at": "2026-09-18T10:15:00.000Z"
  }
}