Templates

List and fetch Scribeless templates for campaign creation.

Use template endpoints when your integration needs to discover the published templates available to the API key's team, then use a compatible template_id and product_id when creating a campaign.

Most integrations create and edit templates in the Scribeless platform UI. Approved partner onboarding flows can also create a default published template through the API; see Default templates.

List templates

GET https://platform.scribeless.co/api/templates

Headers

X-API-Key: YOUR_API_KEY

Example request

curl --request GET 'https://platform.scribeless.co/api/templates' \
  --header 'X-API-Key: YOUR_API_KEY'

Response

Successful requests return active templates with their latest published version and product summary.

[
  {
    "id": "TEMPLATE_ID",
    "name": "Postcard template",
    "created_at": "2026-01-01T10:00:00.000000+00:00",
    "updated_at": "2026-01-01T10:00:00.000000+00:00",
    "published_at": "2026-01-01T10:00:00.000000+00:00",
    "team_id": "TEAM_ID",
    "version": {
      "id": "TEMPLATE_VERSION_ID",
      "version_number": 1,
      "status": "published",
      "pages": [
        {
          "count": 2
        }
      ],
      "product": {
        "id": "PRODUCT_ID",
        "name": "A6 postcard",
        "category": "postcard",
        "standard": "ISO",
        "delivery_methods": [
          "directMail",
          "bulkShipping"
        ]
      }
    }
  }
]

Fetch a template

GET https://platform.scribeless.co/api/templates/{templateId}

Path parameters

Parameter	Type	Description
`templateId`	string	Scribeless template ID.

Example request

curl --request GET 'https://platform.scribeless.co/api/templates/TEMPLATE_ID' \
  --header 'X-API-Key: YOUR_API_KEY'

Response

Successful requests return the template and its latest published version.

{
  "id": "TEMPLATE_ID",
  "name": "Postcard template",
  "status": "active",
  "team_id": "TEAM_ID",
  "created_at": "2026-01-01T10:00:00.000000+00:00",
  "updated_at": "2026-01-01T10:00:00.000000+00:00",
  "published_at": "2026-01-01T10:00:00.000000+00:00",
  "version": {
    "id": "TEMPLATE_VERSION_ID",
    "version_number": 1,
    "status": "published",
    "print_config": "duplex",
    "pages": [
      {
        "count": 2
      }
    ],
    "product": {
      "id": "PRODUCT_ID",
      "name": "A6 postcard",
      "category": "postcard",
      "subcategory": "postcard"
    }
  }
}

Notes

Only templates your API key can access are returned.
The version.product.id value is the product_id to use when creating a campaign with that template.
Templates returned by these endpoints have a published version. Draft template content is not returned.
Template authoring and editing are usually handled in the Scribeless platform UI. Most integrations only need to list or fetch published templates before creating campaigns.
Treat any non-2xx response as failed and inspect the response body for the error message.

Status codes

Status	Meaning
`200`	Template or template list returned, or template created.
`401`	Missing, malformed, invalid, or unauthorized API key.
`500`	Template could not be fetched. Check the template ID and retry, or contact support if it persists.

US postcard safe zones

Safe-zone diagrams and starter HTML for US postcard HTML recipients.

Create campaign

Create a Scribeless campaign through the API.