List platform templates

What it does

Request

GET /ad-accounts/{acc}/platform-templates on https://api.apogee.ad/api/v1.

Path parameters

• acc string path required

  TikTok advertiser id or Snapchat ad account id (GET /ad-accounts?platform=…)

  Matches ^[A-Za-z0-9][A-Za-z0-9-]{0,63}$

Query parameters

• platform string query required

  One of tiktok, snapchat

• level string query required

  One of adgroup, ad

Headers

• Authorization string header required

  Bearer apk_…: an API key with the scope of this route.

Response

200.

• templates array of objects
  Fields of each item (4)

  • id string or null
  • name string or null
  • updated_at string or null
  • params object

    The drawer's params as the app saved them

• platform string

  One of tiktok, snapchat

• level string

  One of adgroup, ad

• available boolean

  false: templates are not set up on this server

Every answer carries X-Request-Id (give it to support), Apogee-Version: 2026-10-06, and the RateLimit and RateLimit-Policy headers.

Errors

Errors are application/problem+json with a stable code to switch on (all the codes).

Example

With your key in APOGEE_API_KEY (create one):

curl 'https://api.apogee.ad/api/v1/ad-accounts/7000000000000000001/platform-templates?platform=tiktok&level=adgroup' \
  -H "Authorization: Bearer $APOGEE_API_KEY"

{
  "platform": "tiktok",
  "level": "adgroup",
  "available": false,
  "templates": [
    {
      "id": "120200000000000001",
      "name": "Nordlicht | Spring launch",
      "updated_at": "2026-10-23T09:00:00.000Z",
      "params": {}
    }
  ]
}

Access and cost

In the MCP

An AI assistant does the same with this tool of the MCP server:

• list_platform_templates: TikTok and Snapchat: the Quick Bulk Edit templates saved in the Apogee app ("Save as template" in the ad group / ad squad and ad params), per ad account. level: "adgroup": an ad group's (TikTok) or an ad squad's (Snapchat) settings; level: "ad": an ad's (TikTok account, texts, URL, call to action…). prepare_launch uses one as its base: tiktok.adgroup_template_id / tiktok.ad_template_id, snapchat.adsquad_template_id / snapchat.ad_template_id. Saving and deleting templates stay in the app.

Related operations

• Create import: POST /imports
• Get import: GET /imports/{id}
• List drive folder: GET /drive-folders
• Create uploads: POST /uploads
• Confirm uploads: POST /uploads/confirm
• List TikTok posts: GET /ad-accounts/{acc}/tiktok-posts
• List TikTok music: GET /ad-accounts/{acc}/tiktok-music