Email Templates

Create email template

Creates a new email template with subject and body.

Placeholder workflow:

  1. GET /template-placeholders — list available placeholders
  2. POST /template-placeholders/prepare — convert chosen placeholder to an HTML <tag> element
  3. Insert the returned HTML tag into the template body
  4. POST /email-templates — save the template with embedded placeholder tags
post/email-templates

Request

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

Request body

company_idinteger

Target company ID.

namestring required

Template name

subjectstring required

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 required

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

Created 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.