Inboxjot
Dashboard

Templates

Auth Required

Update Template

PATCHhttps://api.inboxjot.com/v1/templates/{template_id}

Updates the fields you send in the draft and keeps the others. The change shows live to anyone who has the template open, and it reaches sends after you publish. Needs a Full key. A key limited to one domain answers 403. Send an optional Idempotency-Key header to retry safely. See Idempotency.

PATCH/v1/templates/{template_id}
curl -X PATCH https://api.inboxjot.com/v1/templates/tpl_06d2mfk8r5cx3nd8vt1qa \
  -H "Authorization: Bearer $INBOXJOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Welcome aboard, {{first_name}}"
  }'
{
  "id": "tpl_06d2mfk8r5cx3nd8vt1qa",
  "name": "Welcome",
  "from": "Acme <hello@acme.dev>",
  "reply_to": null,
  "subject": "Welcome aboard, {{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"
}

Returns the updated template.

Path Parameters

template_idstringrequired

The template id.

Body Parameters

namestring | null

The template name, 1 to 200 characters.

fromstring | null

The default from address, up to 320 characters.

reply_tostring | null

The default reply-to address. Send null to clear it.

subjectstring | null

The subject, up to 998 characters, without line breaks.

preheaderstring | null

The preview text, up to 500 characters, without line breaks.

htmlstring | null

The email as HTML. Inboxjot turns it into editor content, so the template stays editable in the dashboard.

contentobject | null

The editor document, as the dashboard saves it. Most callers send html instead. When you send both, html wins.

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

PATCH/v1/templates/{template_id}
curl -X PATCH https://api.inboxjot.com/v1/templates/tpl_06d2mfk8r5cx3nd8vt1qa \
  -H "Authorization: Bearer $INBOXJOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Welcome aboard, {{first_name}}"
  }'
{
  "id": "tpl_06d2mfk8r5cx3nd8vt1qa",
  "name": "Welcome",
  "from": "Acme <hello@acme.dev>",
  "reply_to": null,
  "subject": "Welcome aboard, {{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"
}

Returns the updated template.