Skip to main content
POST
/
unified
/
marketing
/
templates
/
push
Create Push Template
curl --request POST \
  --url https://api.stackone.com/unified/marketing/templates/push \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'x-account-id: <x-account-id>' \
  --data '
{
  "name": "<string>",
  "tags": [
    "<string>"
  ],
  "messages": [
    {
      "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
      "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
      "name": "<string>",
      "message_type": {
        "value": "email",
        "source_value": "Email"
      },
      "message_content": {
        "title": "<string>",
        "subtitle": "<string>",
        "body": "<string>"
      }
    }
  ],
  "passthrough": {
    "other_known_names": "John Doe"
  }
}
'
{
  "statusCode": 201,
  "message": "Record created successfully.",
  "timestamp": "2021-01-01T01:01:01.000Z",
  "data": {
    "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.stackone.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

​
x-account-id
string
required

The account identifier

​
Prefer
string

Set to "heartbeat" to enable keep-alive newline heartbeats during long-running requests. Response includes Preference-Applied: heartbeat header when honored. (RFC 7240)

Example:

"heartbeat"

Body

application/json
​
name
string | null
​
tags
string[] | null
​
messages
object[] | null
​
passthrough
object

Value to pass through to the provider

Example:
{ "other_known_names": "John Doe" }

Response

Record created successfully.

​
statusCode
number
required
Example:

201

​
message
string
required
Example:

"Record created successfully."

​
timestamp
string<date-time>
required
Example:

"2021-01-01T01:01:01.000Z"

​
data
object
required