---
title: "Apply a template's design to a campaign."
method: POST
path: "/api/external/v1/templates/apply"
tags: ["GenPages"]
---

# Apply a template's design to a campaign.

`POST /api/external/v1/templates/apply`

Copies the page design onto the campaign, replacing whatever design it
had. Use it right after creating a campaign — until a campaign has a
design, the pages generated for it are blank.

This overwrites: a campaign that already has a design loses it, and pages
generated afterwards use the new one. Pages already generated keep what
they were built with until they are regenerated.

## Request body

- object
  - `workspace_id` integer, required — The workspace the campaign belongs to.
  - `campaign_id` integer, required — From campaigns/get-list or campaigns/create.
  - `template_id` integer, required — From templates/get-list.

## Response `200`

- union
  - object — campaign was not live
    - `campaign_id` integer
    - `template_id` integer
    - `is_live` boolean
    - `message` string
  - object — campaign already live
    - `campaign_id` integer
    - `template_id` integer
    - `is_live` boolean
    - `message` string

## Other responses

- `404`

## Changes

- **2026-08-18** `29a37db12acb` — 2 breaking, 3 warning
  - added `subschema #1, subschema #2` to the response body `oneOf` list for the response status `200`
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `campaign_id` from the response with the `200` status
  - removed the optional property `message` from the response with the `200` status
  - …1 more
- **2026-08-17** `dd3f47f72f7a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/genpage/apis/genpage-external-api-documentation/changes/api/external/v1/templates/apply/post.md)

---

[API](https://skmtc.dev/genpage/apis/genpage-external-api-documentation.md) · [All operations](https://skmtc.dev/genpage/apis/genpage-external-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/genpage/genpage-external-api-documentation/revisions/29a37db12acb/schema)
