Create Session

POST/print-mail/v1/template_editor_sessions

Create a Template Editor Session.

Note that if no backURL is supplied, PostGrid removes the Back button from the editor page. This is ideal for when you iframe the editor.

Header ParametersExpand Collapse

"idempotency-key": optional string

Body ParametersJSONExpand Collapse

body: object { template, backURL, styles, 2 more } or object { baseTemplate, backURL, styles, 2 more }

Create a Template Editor Session using an existing template.

One of the following:

TemplateEditorSessionCreateWithTemplate object { template, backURL, styles, 2 more }

Create a Template Editor Session using an existing template.

template: string

ID of the underlying template that this edits.

backURL: optional string

The URL supplied when this editor session was created.

formaturi

styles: optional object { canvas, panelText, saveButton }

Style overrides for the template editor session.

canvas: optional object { backgroundColor }

Style overrides for the template editor canvas.

backgroundColor: optional string

The canvas background color.

panelText: optional object { color }

Style overrides for template editor panel text.

color: optional string

The panel text color.

saveButton: optional object { backgroundColor, textColor }

Style overrides for the template editor save button.

backgroundColor: optional string

The save button background color.

textColor: optional string

The save button text color.

title: optional string

The title supplied when this editor session was created.

trackers: optional "all" or "none" or array of string

Controls which Trackers are displayed in the template editor session.

One of the following:

"all" or "none"

One of the following:

"all"

"none"

array of string

TemplateEditorSessionCreateWithBaseTemplate object { baseTemplate, backURL, styles, 2 more }

Create a Template Editor Session by copying an existing template first.

baseTemplate: string

ID of an existing template to use as a starting point. When provided, a new template is created as a copy of baseTemplate and the session is created against the new template instead.

backURL: optional string

The URL supplied when this editor session was created.

formaturi

styles: optional object { canvas, panelText, saveButton }

Style overrides for the template editor session.

canvas: optional object { backgroundColor }

Style overrides for the template editor canvas.

backgroundColor: optional string

The canvas background color.

panelText: optional object { color }

Style overrides for template editor panel text.

color: optional string

The panel text color.

saveButton: optional object { backgroundColor, textColor }

Style overrides for the template editor save button.

backgroundColor: optional string

The save button background color.

textColor: optional string

The save button text color.

title: optional string

The title supplied when this editor session was created.

trackers: optional "all" or "none" or array of string

Controls which Trackers are displayed in the template editor session.

One of the following:

"all" or "none"

One of the following:

"all"

"none"

array of string

ReturnsExpand Collapse

id: string

A unique ID prefixed with template_editor_session_.

createdAt: string

The UTC time at which this session was created.

formatdate-time

live: boolean

true if this is a live mode session else false.

object: "template_editor_session"

Always template_editor_session.

template: string

ID of the underlying template that this edits.

url: string

A URL that can be iframed or redirected to for editing the template.

formaturi

backURL: optional string

The URL supplied when this editor session was created.

formaturi

styles: optional object { canvas, panelText, saveButton }

Style overrides for the template editor session.

canvas: optional object { backgroundColor }

Style overrides for the template editor canvas.

backgroundColor: optional string

The canvas background color.

panelText: optional object { color }

Style overrides for template editor panel text.

color: optional string

The panel text color.

saveButton: optional object { backgroundColor, textColor }

Style overrides for the template editor save button.

backgroundColor: optional string

The save button background color.

textColor: optional string

The save button text color.

title: optional string

The title supplied when this editor session was created.

trackers: optional "all" or "none" or array of string

Controls which Trackers are displayed in the template editor session.

One of the following:

"all" or "none"

One of the following:

"all"

"none"

array of string

Create Session

curl https://api.postgrid.com/print-mail/v1/template_editor_sessions \
    -H 'Content-Type: application/json' \
    -H "X-API-Key: $POSTGRID_PRINT_MAIL_API_KEY" \
    -d '{
          "template": "template"
        }'

{
  "id": "template_editor_session_bBYRQ5DKu3LJ5yNemoAQ7E3or6E7Yzd7FGNWJSXBRrAfcdoNXNGLvfZxAm2dJYiv9c",
  "object": "template_editor_session",
  "live": false,
  "template": "template_eYxcbMKPZEZPk71ZJPA6Yz",
  "backURL": "https://postgrid.com",
  "title": "My Editor Session",
  "trackers": [
    "tracker_123456789abcdefghijklmnopqrstuvwxyz"
  ],
  "url": "https://dashboard.postgrid.com/embed/template_editor_sessions/template_editor_session_bBYRQ5DKu3LJ5yNemoAQ7E3or6E7Yzd7FGNWJSXBRrAfcdoNXNGLvfZxAm2dJYiv9c",
  "createdAt": "2023-07-05T19:36:01.369Z"
}

{
  "id": "template_editor_session_bBYRQ5DKu3LJ5yNemoAQ7E3or6E7Yzd7FGNWJSXBRrAfcdoNXNGLvfZxAm2dJYiv9c",
  "object": "template_editor_session",
  "live": false,
  "template": "template_eYxcbMKPZEZPk71ZJPA6Yz",
  "backURL": "https://postgrid.com",
  "title": "My Editor Session",
  "trackers": "none",
  "url": "https://dashboard.postgrid.com/embed/template_editor_sessions/template_editor_session_bBYRQ5DKu3LJ5yNemoAQ7E3or6E7Yzd7FGNWJSXBRrAfcdoNXNGLvfZxAm2dJYiv9c",
  "createdAt": "2023-07-05T19:36:01.369Z"
}

Returns Examples

{
  "id": "template_editor_session_bBYRQ5DKu3LJ5yNemoAQ7E3or6E7Yzd7FGNWJSXBRrAfcdoNXNGLvfZxAm2dJYiv9c",
  "object": "template_editor_session",
  "live": false,
  "template": "template_eYxcbMKPZEZPk71ZJPA6Yz",
  "backURL": "https://postgrid.com",
  "title": "My Editor Session",
  "trackers": [
    "tracker_123456789abcdefghijklmnopqrstuvwxyz"
  ],
  "url": "https://dashboard.postgrid.com/embed/template_editor_sessions/template_editor_session_bBYRQ5DKu3LJ5yNemoAQ7E3or6E7Yzd7FGNWJSXBRrAfcdoNXNGLvfZxAm2dJYiv9c",
  "createdAt": "2023-07-05T19:36:01.369Z"
}

{
  "id": "template_editor_session_bBYRQ5DKu3LJ5yNemoAQ7E3or6E7Yzd7FGNWJSXBRrAfcdoNXNGLvfZxAm2dJYiv9c",
  "object": "template_editor_session",
  "live": false,
  "template": "template_eYxcbMKPZEZPk71ZJPA6Yz",
  "backURL": "https://postgrid.com",
  "title": "My Editor Session",
  "trackers": "none",
  "url": "https://dashboard.postgrid.com/embed/template_editor_sessions/template_editor_session_bBYRQ5DKu3LJ5yNemoAQ7E3or6E7Yzd7FGNWJSXBRrAfcdoNXNGLvfZxAm2dJYiv9c",
  "createdAt": "2023-07-05T19:36:01.369Z"
}