PricingDocsCompareGuidesBlog
API referenceTemplates

List templates

GET/templates

Newest first, cursor-paginated.

Authorization

apiKey
AuthorizationBearer <token>

A project API key: Authorization: Bearer s0_…

In: header

Query Parameters

limit?integer
Range1 <= value <= 100
after?string
Length1 <= length <= 64
before?string
Length1 <= length <= 64

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/templates"
{  "object": "list",  "has_more": true,  "data": [    {      "alias": "string",      "created_at": "2019-08-24T14:15:22Z",      "id": "string",      "name": "string",      "object": "template",      "published_at": "2019-08-24T14:15:22Z",      "status": "draft",      "updated_at": "2019-08-24T14:15:22Z"    }  ]}

Download an attachment of a received email GET

The bytes of one attachment, with the same authentication as the listing. On Cloudflare it is read from your R2 bucket with the runtime token and answered as a download; on Amazon SES it redirects to a presigned S3 URL. `expires` (from the `download_url`) is checked when present.

Create a template POST

Saves a draft with HTML, optional text, subject, preheader, sender defaults and up to 50 variables (`{{{KEY}}}`, `{{{KEY|fallback}}}` or `{{ KEY | default: "x" }}`). Publish it before sending with it. React Email is not compiled server-side: send the rendered `html` (`react` is stored as source only).