Skip to main content
Use headers in a send request to add your own headers to the email, for example a reference ID your support team can search for, or a header your own systems read on replies. Available on Free, Pro and Max. See plans and features.

How do I add a header?

headers is an object of header names and values. A {{ variable }} in a value is filled from the recipient’s substitutions:

Which rules apply to header names and values?

  • A name must be visible ASCII, with no space and no colon. An empty name, or one with a space, a colon or a line break, is rejected.
  • A substitution value used in a header must not contain a line break; the request is rejected and the error names the recipient.
  • Header values are inserted as they are, without HTML escaping.

Which headers does AhaSend set for me?

Tracking, tags, retention and sandbox mode have their own fields in the API: see Tags and Tracking and retention per message. Over SMTP, the same settings use special headers.