---
title: "List campaign templates"
method: GET
path: "/api/v1/templates"
tags: ["Templates"]
---

# List campaign templates

`GET /api/v1/templates`

## Request

- Base URL: `https://app.convertflow.co`
- URL: `https://app.convertflow.co/api/v1/templates`
- Auth: HTTP bearer

Templates the account can build campaigns and variants from: its own saved templates plus the public library, 25 per page, newest first. Pass a template id as template_id to POST /campaigns or POST /campaigns/{id}/variants. Requires the templates:read scope on OAuth tokens.

## Query parameters

- `cta_type` 'page' | 'overlay' | 'hook' | 'bar' | 'inline'
- `name` string
- `page` integer

## Response `200`

filtered by name

- object[]
  - `id` integer
  - `name` string
  - `description` unknown
  - `cta_type` string: Campaign format
  - `screenshot` unknown
  - `official` boolean
  - `public` boolean
  - `premium` unknown
  - `times_used` integer
  - `tags` unknown[]
    - unknown
  - `created_at` string, date-time

## Other responses

- `403`: token lacks the templates:read scope

---

[API](https://skmtc.dev/convertflow/apis/convertflow-api.md) - [All operations](https://skmtc.dev/convertflow/apis/convertflow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/convertflow/apis/convertflow-api/revisions/9a45e0736b68?raw)