Make a template

Saves a text with {{variables}}. A variable is a contact field (first_name, last_name, company), one of their custom fields, or a value you pass when sending; {{first_name|there}} uses “there” when the contact has no first name. A variable that is empty with no fallback is left out, along with the space before it.

Needs a key with the messages:send scope. Keys and scopes

Send an Idempotency-Key so a retry never acts twice. Idempotency

Headers

• Idempotency-Keystring

  Any string of up to 255 characters, new for each request. A retry with the same key gets the first answer back for 24 hours, with Idempotent-Replayed: true.

  Up to 255 characters.

Request body

• namestringrequired

  A name, unique among your templates whatever its capitals.

  Up to 80 characters.

• bodystringrequired

  The text, up to 2,000 characters, with {{variables}} and {{variable|fallback}}.

  Up to 2,000 characters.

Example

curl -X POST "https://usebluebot.com/api/v1/templates" \
  -H "Authorization: Bearer $BLUEBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 0f6d8c2e-5b1a-4c7e-9d3f-2a8b6e1c4d70" \
  -d '{
    "name": "Showing reminder",
    "body": "Hi {{first_name|there}}, see you at {{showing}} tomorrow."
  }'

Response

201: The new template.

• idstringrequired

  A tpl_ id.

  Starts with tpl_.

• object"template"required
• namestringrequired

  Its name, unique among your templates.

• bodystringrequired

  The text, with {{variables}} and {{variable|fallback}}.

• variablesarray of stringsrequired

  The variables the text names, in order, once each.

• created_attimestamprequired

  When it was made.

• updated_attimestamprequired

  When it last changed.

{
  "id": "tpl_1Hq2LxW9cVbN3mKpRtYs0a",
  "object": "template",
  "name": "Showing reminder",
  "body": "Hi {{first_name|there}}, see you at {{showing}} tomorrow.",
  "variables": [
    "first_name",
    "showing"
  ],
  "created_at": "2026-11-10T16:00:00.000Z",
  "updated_at": "2026-11-10T16:00:00.000Z"
}

Errors

Every refusal has the same envelope and a page of its own. These are the ones this operation can give.

Try it