List templates | Nexiom Connect

GET/v1/emails/templates

Authorization

Bearer token

Authorizationrequiredheader: Send your API key as Bearer YOUR_API_KEY.
Permissionemail.full_access

Query parameters

pageinteger

Page number, starting at 1; defaults to 1.

limitinteger

1–100; defaults to 50.

statusstring

See Templates.

One of"draft""published""changes_in_draft""archived"

searchstring

Matches the name, alias, or description.

originstring

One of"custom""prebuilt"

categorystring

Exact category.

Response

application/json200 OK

Templates are ordered by most recently updated. Each item has the same fields as Retrieve a template. Use total, page, and limit to request further pages.

curl "https://api-connect.nxiom.com/api/v1/emails/templates?status=published&limit=50" \
  -H "Authorization: Bearer $NEXIOM_API_KEY"

Set NEXIOM_API_KEY in your environment.

{
  "message": "Email templates fetched",
  "data": {
    "items": [
      {
        "id": "template_example",
        "organization_id": "organization_example",
        "project_id": "project_example",
        "name": "Welcome",
        "alias": "welcome",
        "description": null,
        "category": null,
        "origin": "custom",
        "locale": "en",
        "draft_version_id": null,
        "published_version_id": "version_example",
        "archived_at": null,
        "usage_count": 12,
        "last_used_at": "2026-10-03T09:00:00.000Z",
        "created_at": "2026-09-20T09:00:00.000Z",
        "updated_at": "2026-09-21T09:00:00.000Z",
        "draft_version": null,
        "published_version": {
          "id": "version_example",
          "template_id": "template_example",
          "version_number": 2,
          "status": "published",
          "subject": "Welcome, {{first_name}}",
          "preview_text": null,
          "from_name": null,
          "from_address": null,
          "reply_to": null,
          "content": {},
          "html": "<p>Hi {{first_name}}</p>",
          "text": "Hi {{first_name}}",
          "thumbnail_url": null,
          "editor_revision": 4,
          "created_by_customer_id": null,
          "published_by_customer_id": null,
          "published_at": "2026-09-21T09:00:00.000Z",
          "created_at": "2026-09-21T08:00:00.000Z",
          "updated_at": "2026-09-21T09:00:00.000Z",
          "variables": [
            {
              "id": "variable_example",
              "key": "first_name",
              "type": "string",
              "required": true,
              "fallback_value": null
            }
          ]
        }
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 50
  }
}

Example successful response.

Authorization#

Query parameters#

Response#

Authorization

Query parameters

Response