> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.conversive.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.conversive.ai/_mcp/server.

# List, Search or Filter Templates

`GET https://api.beconversive.com/api/v2/templates`

Returns a paginated list of the account's templates, newest first. Use the query parameters to search and filter.

```bash
curl -G https://api.beconversive.com/api/v2/templates \
  -H "apiKey: <API_KEY>" \
  --data-urlencode "name=welcome" \
  --data-urlencode "channel=sms,whatsapp" \
  --data-urlencode "page=1"
```

**200 Retrieved**

```json
{
  "total_items": 1,
  "page_number": 1,
  "result": [
    {
      "id": 102031,
      "name": "Welcome",
      "template": "Hi, welcome!",
      "channel": "sms",
      "category": "TextOnly",
      "modified_on": "2026-11-13T09:30:00Z"
    }
  ]
}
```

## Authentication

| Name     | Type   | Required | Description                        |
| -------- | ------ | -------- | ---------------------------------- |
| `apiKey` | string | Required | API key authentication via header. |

## Query parameters

| Name          | Type    | Required | Description                                                  |
| ------------- | ------- | -------- | ------------------------------------------------------------ |
| `name`        | string  | Optional | Returns templates whose name contains this text.             |
| `type`        | string  | Optional | `automation`, `campaign` or `conversation`.                  |
| `category`    | string  | Optional | `only_text`, `media_message` or `rich_media`.                |
| `channel`     | string  | Optional | `sms`, `whatsapp`, `rcs`, `line`, `web`, `email` or `voice`. |
| `integration` | string  | Optional | Integration name as saved on the template, e.g. `hubspot`.   |
| `label`       | string  | Optional | Label ID, or label name together with `user_id`.             |
| `created_by`  | string  | Optional | User IDs. Use `-1` for templates created by other users.     |
| `page`        | integer | Optional | Page number, starting at 1. Default 1.                       |
| `page_size`   | integer | Optional | Results per page, 10 to 1000. Default 10.                    |

> **Note**
>
> To filter by several values, separate them with commas, e.g. `channel=sms,whatsapp`.

## Response

| Name          | Type            | Description                                                          |
| ------------- | --------------- | -------------------------------------------------------------------- |
| `total_items` | integer         | Total number of matching templates.                                  |
| `page_number` | integer         | Page returned.                                                       |
| `result`      | list of objects | Matching templates. See Get Template Detail for the template object. |

## Errors

| Status           | Error                              | Description                                                 |
| ---------------- | ---------------------------------- | ----------------------------------------------------------- |
| 400 Bad Request  | `MISSING-USER-ID-IN-REQUEST`       | `label` was given as a name without `user_id`.              |
| 401 Unauthorized | `NO-API-KEY` / `FORBIDDEN-API-KEY` | The API key is missing or not valid.                        |
| 403 Forbidden    | —                                  | More than 25 requests in a minute. Wait a minute and retry. |