# Add your own headers to any email you send
URL: https://samva.dev/changelog/add-your-own-headers-to-an-email-you-send
> Pass a headers map on a send and Samva copies it onto the outgoing email, from the API, the SDK, or the CLI. Names Samva owns are rejected.
- Published: 2026-10-23
- Tags: api, sdk, cli



An email can now carry headers of your own, such as a tag your mail system reads back later. Add a `headers` map to a send and Samva copies it onto the message.

**What you need to do.** Nothing, unless you want a header. One email takes up to 11, and a name Samva writes itself, like `From`, is rejected with a `422` that names it. In the CLI, repeat `--header 'Name: Value'`.

```ts
await samva.email.send({
  to: "ada@example.com",
  subject: "Your sign-in code",
  text: "Your code is 123456.",
  headers: { "OTP-Token": "123456" },
});
```

## Links

- [Set custom headers](/docs/channels/email/send-an-email#set-custom-headers)
- [samva 0.26.0 on npm](https://www.npmjs.com/package/samva/v/0.26.0)
- [@samva/cli 0.25.0 on npm](https://www.npmjs.com/package/@samva/cli/v/0.25.0)

## Related

- [Upgrading to samva 0.27: changes since 0.11](/changelog/upgrade-to-samva-0-27)
- [Edit a template's sending defaults in the dashboard](/changelog/edit-a-templates-sending-defaults-in-the-dashboard)
- [All changelog entries](/changelog)