Skip to main content
POST
/
v2
/
{workspace}
/
template
/
{template_slug}
Upsert Template
curl -X POST "https://management-api.suprsend.com/v2/{workspace}/template/{template_slug}/" \
  --header 'Authorization: ServiceToken <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Order Confirmed",
    "description": "Sent when an order is placed",
    "tags": ["transactional"],
    "enabled_channels": ["email", "sms"]
  }'
{
  "$schema": "https://schema.suprsend.com/template/v2/schema.json",
  "slug": "welcome-onboarding",
  "created_at": "2026-04-01T05:57:21.081312Z",
  "last_triggered_at": null,
  "name": "Welcome Onboarding",
  "description": "Welcome email for new users",
  "tags": [
    "onboarding",
    "welcome"
  ],
  "enabled_channels": [
    "email",
    "slack"
  ],
  "status": "draft",
  "version_no": null,
  "hash": "74335de96f6ddc077b90310ff746a8f8cd64852acbbe260c626be54ff28bed0d",
  "commit_message": null,
  "active_at": null,
  "updated_at": "2026-04-08T09:24:38.918548Z",
  "updated_by": {
    "name": "API Service",
    "email": "service-token@api.example.com"
  },
  "channels": [
    {
      "channel": "email",
      "is_active": false,
      "variants_count": 1
    },
    {
      "channel": "slack",
      "is_active": false,
      "variants_count": 1
    }
  ]
}

Authorizations

ServiceToken <token>
string
header
required

You can get Service Token from SuprSend dashboard -> Account Settings -> Service Tokens section.

Path Parameters

workspace
string
required

Workspace slug.

template_slug
string
required

Unique template slug. Used as the identifier for the template.

Body

application/json
name
string
required

Template display name.

Example:

"Order Confirmed"

description
string

Optional description for the template.

Example:

"Sent when an order is placed"

tags
string[]

Tags for organising templates.

Example:
["transactional"]
enabled_channels
enum<string>[]

Channels to enable for this template.

Available options:
email,
sms,
whatsapp,
inbox,
androidpush,
iospush,
webpush,
slack,
ms_teams
Example:
["email", "sms"]

Response

Template created or updated successfully

The response is of type object.