PlunkPlunk
API ReferenceTemplates

List templates

Get a paginated list of email templates.

This endpoint uses offset pagination (page / pageSize), not the cursor pagination used by GET /contacts.

GET
/templates

Authorization

ApiKeyAuth

AuthorizationBearer <token>

API Key authentication. The project is automatically derived from the key.

/v1/track requires a public key (pk_*) — it is the one endpoint intended for client-side use, and a secret key is rejected there with 401.

Every other endpoint requires a secret key (sk_*) and rejects public keys with 401.

So the two key types are not interchangeable in either direction: pick the key that matches the endpoint you are calling.

In: header

Query Parameters

page?integer

1-based page number.

Default1
Range1 <= value
pageSize?integer

Items per page.

Default20
Range1 <= value
type?string

Filter by template type.

Value in"TRANSACTIONAL" | "MARKETING" | "HEADLESS"
search?string

Case-insensitive match on name, description, or subject.

sort?string

Column to sort by. Unrecognised values fall back to createdAt.

Default"createdAt"
Value in"name" | "createdAt" | "updatedAt"
dir?string

Sort direction. Unrecognised values fall back to the default.

Default"desc"
Value in"asc" | "desc"

Response Body

application/json

application/json

curl -X GET "https://api.plunk.jimster.dev/templates"
{
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "subject": "string",
      "body": "string",
      "from": "user@example.com",
      "fromName": "string",
      "replyTo": "user@example.com",
      "type": "TRANSACTIONAL",
      "projectId": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "total": 0,
  "page": 0,
  "pageSize": 0,
  "totalPages": 0
}
{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid secret API key. This endpoint requires a secret key (sk_*), not a public key.",
    "statusCode": 401,
    "requestId": "8f14e45f-ceea-467a-9575-1f0f38e0b1c2"
  },
  "timestamp": "2025-01-15T10:30:00.000Z"
}