Email templates

If you have questions regarding this API, please visit our API FAQ page.

Email templates are built in the Inboxroad template builder. This endpoint is read-only — templates cannot be created or edited through the API. A template’s id is what you pass as welcome_email_template_id when creating or updating a contacts list.

Listing email templates

Make a GET request to https://webapi.inboxroad.com/api/v2/email-templates/ with a valid X-API-Key (see v2 authentication).

curl -X GET 'https://webapi.inboxroad.com/api/v2/email-templates/' \
  -H 'X-API-Key: <your_token>' \
  -H 'Content-Type: application/json'

Returns 200 with an array of email template objects (not paginated).

Email template object

Field name	Description
id	Unique identifier of the template (UUID).
name	Human-readable name of the template.
html	Rendered HTML body.
text_content	Plain-text body.
json_data	Builder design document used to regenerate the template.
template_type	One of `plain`, `html`, `unlayer`.
created_at	Date and time the template was created.
updated_at	Date and time the template was last updated.

Example response

[
  {
    "id": "7d1f0a2b-3c4d-5e6f-7a8b-9c0d1e2f3a4b",
    "name": "Welcome – Newsletter",
    "html": "<html><body>Welcome aboard!</body></html>",
    "text_content": "Welcome aboard!",
    "json_data": { "body": { "rows": [] } },
    "template_type": "unlayer",
    "created_at": "2026-05-01T08:30:00Z",
    "updated_at": "2026-05-12T10:15:00Z"
  }
]

Possible response codes

Status code	Description
200	Email templates retrieved successfully.
401	Unauthorized.