Skip to main content
POST
/
api
/
templates.create
Create a template
curl --request POST \
  --url https://{notifuseDomain}/api/templates.create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workspace_id": "ws_1234567890",
  "id": "welcome_email",
  "name": "Welcome Email",
  "channel": "email",
  "category": "transactional",
  "template_macro_id": "<string>",
  "test_data": {},
  "settings": {}
}
'
{
  "template": {
    "id": "welcome_email",
    "name": "Welcome Email",
    "channel": "email",
    "category": "transactional",
    "version": 1,
    "email": {
      "subject": "Welcome, {{user_name}}!",
      "compiled_preview": "<string>",
      "visual_editor_tree": {
        "type": "mjml",
        "children": []
      },
      "sender_id": "sender_123",
      "reply_to": "support@example.com",
      "subject_preview": "Get started with your account",
      "text": "<string>"
    },
    "web": {
      "content": {},
      "html": "<string>",
      "plain_text": "<string>"
    },
    "template_macro_id": "<string>",
    "integration_id": "<string>",
    "test_data": {
      "user_name": "John Doe",
      "action_url": "https://example.com/action"
    },
    "settings": {},
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "deleted_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

API token for authentication

Body

application/json
​
workspace_id
string
required

The ID of the workspace

Example:

"ws_1234567890"

​
id
string
required

Unique identifier for the template (alphanumeric, underscores, and hyphens only)

Maximum string length: 32
Pattern: ^[a-zA-Z0-9_-]+$
Example:

"welcome_email"

​
name
string
required

Name of the template

Maximum string length: 32
Example:

"Welcome Email"

​
channel
enum<string>
required

Communication channel

Available options:
email,
web
Example:

"email"

​
category
enum<string>
required

Template category

Available options:
marketing,
transactional,
welcome,
opt_in,
unsubscribe,
bounce,
blocklist,
blog,
other
Example:

"transactional"

​
email
object
​
web
object
​
template_macro_id
string | null

ID of the template macro (layout) to use

​
test_data
object

Test data for template preview

​
settings
object

Channel-specific settings

Response

Template created successfully

​
template
object