Email Templates

Update email template

Updates an existing email template. Only provided fields are overwritten; omitted fields keep their current values.

To add placeholders to the body, use the same workflow as for creation:

  1. GET /template-placeholders — list available placeholders
  2. POST /template-placeholders/prepare — get HTML tag for the chosen placeholder
  3. Insert the tag into the body and PUT /email-templates/{id}
put/email-templates/{id}

Request

  • Base URL: https://api.100hires.com/v2
  • URL: https://api.100hires.com/v2/email-templates/{id}
  • Auth: HTTP bearer

Path parameters

idinteger required

Resource ID (numeric).

Request body

namestring

Template name

subjectstring

Email subject line. Plain text.

Placeholders: literal {{first_name}} / {{job_title}} tokens are NOT substituted — they will be delivered to the recipient verbatim. To embed a placeholder, call POST /template-placeholders/prepare and paste the returned HTML <tag>…</tag> string into this field.

bodystring

Email body HTML.

Placeholders: literal {{first_name}} tokens are NOT substituted — the recipient will see the raw text. To embed a placeholder, call POST /template-placeholders/prepare and insert the returned <tag contenteditable="false" data-type="…" data-identifier="…">…</tag> element into the HTML at the position where the value should appear.

Response

Updated email template

idinteger

Email template ID

namestring

Template name

subjectstring

Email subject line as stored. Placeholders, when present, are stored as <tag> HTML produced by POST /template-placeholders/prepare; they are rendered to real values only at send time, not on read.

bodystring

Email body HTML as stored. Placeholders are stored as <tag> HTML produced by POST /template-placeholders/prepare and rendered at send time. Present only when view=full (default); omitted entirely when view=summary — template bodies can be tens of KB each.

url_backofficestring uri

Absolute backoffice URL to edit this email template in the 100Hires recruiter app. Use to render deep-links in agent UIs.

created_atinteger

Unix timestamp

updated_atinteger

Unix timestamp

Example response

{
  "url_backoffice": "https://app.100hires.com/settings/message-templates/edit?id=42"
}

Changes

No recorded changes to this operation across all 1 revision of this API.