List email templates

Overview

Get email templates selectable for the caller as a {value, label} dropdown source. The list combines the given store's templates (when you provide store_id), the caller account's templates, and global templates (where company_id is NULL). Results are sorted by name.

Prerequisites

• A bearer token in the Authorization header.

Base URL

Endpoint

GET /api/v1/campaign/template/email/list

Authentication

• Requires a bearer token in the Authorization: Bearer <bearer-token> header.

• bearer token, account role — authentication. The endpoint scopes company templates to user.person.company_id; store_id (optional) must belong to the caller's account hierarchy.

Rate limit

• No rate limit.

Query parameters

How it works

• Synchronous, not paginated. 200 OK with data.response = array of {value, label}. 422 on invalid store_id.

Response

200 OK · 200

{
  "data": {
    "status": "success",
    "response": [
      {
        "value": 1,
        "label": "Welcome Email Template"
      },
      {
        "value": 2,
        "label": "Follow-up Email Template"
      }
    ]
  }
}

Errors

Example request

curl --request GET \
  --url "https://production-api.shoutaboutus.com/api/v1/campaign/template/email/list?store_id=123&template_type=regular" \
  --header 'Authorization: Bearer <bearer-token>' \
  --header 'Accept: application/json'