Browse documentation

Email API

2 endpoints for email workflows. Every call requires bearer authentication and uses the standard ToolsOnDuty response envelope.

Try it

Runs a real request from your browser to your own ToolsOnDuty account. Your key is only kept in this page and is never stored.

EndpointAPI key

raw *

POST/v1/email/analyze-headers1 credit / call

Email header analyzer

Parse supplied raw email headers, summarize reported SPF/DKIM/DMARC results, reconstruct Received hops and flag common sender-domain mismatches. This does not query DNS or independently verify signatures.

Parameter	Type	Required	Description
raw	string	Yes	Raw email headers, optionally followed by the message body.

Request

curl -X POST https://toolsonduty.com/api/v1/email/analyze-headers \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"raw":"From: Billing <[email protected]>\nReply-To: [email protected]\nAuthentication-Results: mx.example; spf=pass; dkim=pass; dmarc=pass\nMessage-ID: <[email protected]>"}'

Response

{
  "ok": true,
  "data": {
    "authentication": {
      "spf": "pass",
      "dkim": "pass",
      "dmarc": "pass"
    },
    "route": [],
    "signals": [
      {
        "level": "warning",
        "title": "Reply-To domain differs from From"
      }
    ]
  }
}

POST/v1/email/generate-signature1 credit / call

Professional email signature generator

Generate escaped, table-based email signature HTML with professional templates, contact details, HTTPS social links, an optional CTA and one optional logo.

Parameter	Type	Required	Description
name	string	Yes	Display name.
pronouns	string	No	Optional pronouns displayed beside the name.
role	string	No	Job title or role.
department	string	No	Department or team.
company	string	No	Company or organization.
tagline	string	No	Optional short professional tagline.
email	string	No	Contact email address.
phone	string	No	Mobile or primary phone number.
officePhone	string	No	Optional office phone number.
website	string	No	HTTPS website URL.
address	string	No	Office or mailing address.
linkedin	string	No	HTTPS LinkedIn profile URL.
x	string	No	HTTPS X profile URL.
facebook	string	No	HTTPS Facebook profile URL.
instagram	string	No	HTTPS Instagram profile URL.
template	string	No	modern \| executive \| compact. Default: modern.
accent	string	No	Six-digit accent hex color. Default: #4f46e5.
ctaLabel	string	No	Optional call-to-action label.
ctaUrl	string	No	Optional HTTPS call-to-action URL.
disclaimer	string	No	Optional legal disclaimer text.
environmentalNotice	string	No	Optional environmental notice.
logoUrl	string	No	Optional HTTPS or data-image logo source.
logoAlt	string	No	Accessible alternative text for the logo.
logoPlacement	string	No	top \| left \| right \| bottom. Default: left.
logoWidth	number	No	Logo width from 24 to 320 pixels. Default: 96.
logoLinkUrl	string	No	Optional HTTPS destination when the logo is clicked.

Request

curl -X POST https://toolsonduty.com/api/v1/email/generate-signature \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"name":"Alex Morgan","role":"Product Designer","company":"Example Studio","email":"[email protected]","website":"https://example.com","template":"modern","accent":"#4f46e5"}'

Response

{
  "ok": true,
  "data": {
    "html": "<table role=\"presentation\" ...>...</table>",
    "template": "modern",
    "imageCount": 0
  }
}