> For the complete documentation index, see [llms.txt](https://scalemate.gitbook.io/scalemate-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://scalemate.gitbook.io/scalemate-api/api/campaign-templates.md).

# Campaign templates

List your **Campaign Launcher** templates and check which ones can be launched through the [Launch Campaigns](https://www.scalemate.co/docs/api/launch-campaigns) endpoint. Each template comes with a compatibility verdict, so you can see up front which are launchable and why the rest are not.

### Endpoint Details

URL: `https://api.scalemate.co/api/external/v2/templates`

Method: `GET`

### Headers

```
Content-Type: application/json
X-Api-Key: <YOUR_API_KEY>
```

You can generate the API Key at the [Settings](https://app.scalemate.co/profile) page under the API Key section.

### Example cURL Request

```bash
curl --location 'https://api.scalemate.co/api/external/v2/templates' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <YOUR_API_KEY>'
```

### Example Response

```json
{
  "templates": [
    {
      "id": 123,
      "name": "US prospecting",
      "platform_type": "facebook",
      "ad_account_id": "1234567890",
      "adset_count": 2,
      "supported": true,
      "unsupported_reasons": [],
      "updated_at": "2026-07-16T10:00:00Z"
    }
  ]
}
```

### Response fields

| Field                 | Description                                                                                                                 |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `id`                  | Template id — pass as `template_id` to the [Launch Campaigns](https://www.scalemate.co/docs/api/launch-campaigns) endpoint. |
| `name`                | Template name.                                                                                                              |
| `platform_type`       | `facebook` or `tiktok`. Only `facebook` is launchable in v2.                                                                |
| `ad_account_id`       | Ad account the template launches into.                                                                                      |
| `adset_count`         | Number of ad sets in the template.                                                                                          |
| `supported`           | `true` if the template can be launched through the API.                                                                     |
| `unsupported_reasons` | Machine-readable reasons the template can't be launched (empty when `supported` is `true`).                                 |

### `unsupported_reasons` codes

| Code                    | Meaning                                                                      |
| ----------------------- | ---------------------------------------------------------------------------- |
| `platform_not_facebook` | Only Facebook templates are supported in v2 (e.g. TikTok templates are not). |
| `app_promotion`         | App-promotion / SKAdNetwork campaigns are not supported in v2.               |
| `dynamic_creative`      | The template has a Dynamic Creative ad set.                                  |
| `missing_ad_account`    | The template has no ad account set.                                          |
| `missing_page_id`       | An ad set is missing a Facebook Page in its ad defaults.                     |
| `no_campaigns`          | The template has no campaigns.                                               |

Returns your **active** templates only, newest first.