Publish Template

POSThttps://api.inboxjot.com/v1/templates/{template_id}/publish

Makes the draft the version that API and automation sends use. Returns 409 when the draft matches the published version. Needs a Full key. A key limited to one domain answers 403. Send an optional Idempotency-Key header to retry safely. See Idempotency.

POST/v1/templates/{template_id}/publish

1
2

curl -X POST https://api.inboxjot.com/v1/templates/tpl_06d2mfk8r5cx3nd8vt1qa/publish \
  -H "Authorization: Bearer $INBOXJOT_API_KEY"

{
  "id": "tpl_06d2mfk8r5cx3nd8vt1qa",
  "name": "Welcome",
  "from": "Acme <hello@acme.dev>",
  "reply_to": null,
  "subject": "Welcome to Acme, {{first_name}}",
  "preheader": "Here is how to get started",
  "html": "<!DOCTYPE html><html>…</html>",
  "text": "Hi Suhasinee, welcome to Acme…",
  "published_version_id": "ver_06d2mfk8r5cx3nd8vt1qb",
  "has_unpublished_changes": false,
  "created_at": "2026-10-21T09:00:00.000Z",
  "updated_at": "2026-10-21T09:00:00.000Z"
}

Published the draft. New sends use it.

Path Parameters

template_idstringrequired

The template id.

Response

idstring

The template id.

namestring

The template name.

fromstring

The default from address.

reply_tostring | null

The default reply-to address.

subjectstring

The subject.

preheaderstring

The preview text.

htmlstring

The rendered HTML.

textstring

The plain text version.

published_version_idstring | null

The version that sends use. null until the first publish, and sends fail until then.

has_unpublished_changesboolean

Whether the draft differs from the version that sends use.

created_atstring

When it was created.

updated_atstring

When it last changed.

Responses

{ "id": "tpl_06d2mfk8r5cx3nd8vt1qa", "name": "Welcome", "from": "Acme <hello@acme.dev>", "reply_to": null, "subject": "Welcome to Acme, {{first_name}}", "preheader": "Here is how to get started", "html": "<!DOCTYPE html><html>…</html>", "text": "Hi Suhasinee, welcome to Acme…", "published_version_id": "ver_06d2mfk8r5cx3nd8vt1qb", "has_unpublished_changes": false, "created_at": "2026-10-21T09:00:00.000Z", "updated_at": "2026-10-21T09:00:00.000Z" }