List templates

Your saved texts, newest first, with the variables each one names. q finds them by name.

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

Query parameters

• qstring

  Only templates whose name or words have this in them.

  Up to 80 characters.

• limitinteger

  How many to return, 1 to 100. Default 25.

  1 to 100.Default 25.

• cursorstring

  The next_cursor of the page before. Leave it out for the first page.

  Up to 200 characters.

Example

curl "https://usebluebot.com/api/v1/templates" \
  -H "Authorization: Bearer $BLUEBOT_API_KEY"

Response

200: A page of templates.

• object"list"required
• dataarray of Templaterequired
  Show its 7 fieldsHide its fields

  • 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.

• has_morebooleanrequired

  Whether another page follows.

• next_cursorstring or nullrequired

  Send as cursor for the next page; null on the last.

{
  "object": "list",
  "data": [
    {
      "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"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Errors

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

Try it