For the complete documentation index, see llms.txt. This page is also available as Markdown.

Campaign templates

List your Campaign Launcher templates and check which ones can be launched through the 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 page under the API Key section.

Example cURL Request

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

Example Response

{
  "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 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.

Last updated