# Sending Emails {#sending-emails}


Nitrosend supports two ways to send emails: **campaigns** for bulk sends to a list, and **transactional messages** for one-off sends triggered by your app.

Before marketing sends, confirm audience permission, sender authentication and
unsubscribe handling. [Sending to Outlook and Microsoft 365](https://docs.nitrosend.com/guides/microsoft-delivery.md)
explains those requirements and how to investigate accepted mail that reaches Junk.


## Campaigns {#campaigns}


Campaigns let you send an email to a contact list or segment. Create one from the dashboard:

1. Go to **Campaigns > New Campaign** ([app.nitrosend.com/my/campaigns](https://app.nitrosend.com/my/campaigns))
2. Choose a template or start from scratch
3. Select your audience (a contact list or segment)
4. Preview, test, and send


## Transactional messages {#transactional-messages}


For receipts, password resets, and other triggered emails, use the API:

```bash
curl -X POST https://api.nitrosend.com/v1/my/messages \
  -H "Authorization: Bearer nskey_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: receipt-order-123" \
  -d '{
    "channel": "email",
    "to": "user@example.com",
    "subject": "Your receipt",
    "html": "<h1>Thanks for your purchase</h1>",
    "body": "Thanks for your purchase"
  }'
```

Every send needs an idempotency key, one per message: a retry with the same key and payload returns the original message instead of sending twice. A request without one returns `400 idempotency_key_required`.

Transactional email accepts `cc` and `bcc` arrays of up to 10 addresses each. The SDK uses the same fields; the CLI accepts `--cc one@example.com,two@example.com` and `--bcc records@example.com`. Copies are email-only, not SMS.

Each distinct To, CC and BCC recipient counts toward
email credits, your rolling 24-hour sending allowance and sending rates. A copy
of every campaign email also uses one credit per copy. Duplicate addresses in
the same email count once; BCC addresses remain private.

Individual flow and transactional messages receive priority headroom ahead of
campaigns when they share sending resources. This does not bypass content review,
suppression or provider limits. Mail queued for pacing continues automatically;
do not submit it again with another idempotency key. The delivery-status response
reports pacing separately from your plan allowance. See
[shared sender rates](https://docs.nitrosend.com/guides/sending-domains.md#use-your-nitrosend-address).

Links in transactional messages go straight to their destination. Nitrosend never rewrites them for click tracking, because they often carry sign-in, reset, or confirmation tokens. Open tracking still follows the brand setting in [Open and click tracking](#open-and-click-tracking).


## Email editor {#email-editor}


The drag-and-drop editor lets you build responsive emails visually. Your brand theme (colors, fonts, logo) is applied automatically. All emails are rendered as MJML under the hood for maximum inbox compatibility.


## Sending activity {#sending-activity}


The sending activity log shows individual sends across campaigns, flows, transactional messages, and tests. Use it to inspect delivery status, failures, and message details after a send.

Use the suppressions API when you need the account-level block list and bounce
diagnostic text behind failed recipients. `GET /v1/my/suppressions` returns the
suppressed address, reason, source event reference, and bounded provider
diagnostic when available.


## Open and click tracking {#open-and-click-tracking}


Nitrosend measures opens with a small image in the HTML part of each email, and clicks by sending links through a tracking redirect. Both are on for every brand by default and feed the **Opened** and **Clicked** numbers in Activity and the engagement filters in segments.

Turn either off for a brand under **Brand > Sender > Engagement tracking** ([app.nitrosend.com/my/brand/sender](https://app.nitrosend.com/my/brand/sender)), or set `email_track_opens` or `email_track_clicks` to `false` on `PATCH /v1/my/brands/{sid}` (see the [API Reference](https://docs.nitrosend.com/api.md)). The card shows the current setting, and `GET /v1/my/brands/{sid}` returns both fields.

- **Open tracking off**: emails carry no tracking image.
- **Click tracking off**: links point straight to their destination. Links in [transactional messages](#transactional-messages) never go through the redirect, whatever the setting.
- The unsubscribe link is never rewritten.

The change applies to emails rendered after you save it. A campaign already sending switches over from its next batch. Emails already delivered keep their image and links, and their links redirect as before, but opens and clicks from them are no longer recorded.

Opens and clicks recorded before you turned tracking off stay in Activity and segments. To delete them, email [contact@nitrosend.com](mailto:contact@nitrosend.com): support deletes the recorded events for the tracking you turned off, segment engagement is rebuilt without them, and aggregate counts stay.


## View in browser {#view-in-browser}


Emails sent from Nitrosend can include a view-in-browser snapshot. This gives recipients a stable web version of the email and gives your team a reliable way to inspect what was sent after delivery.

Turn the link on for a brand under **Brand > Sender > View in browser link** ([app.nitrosend.com/my/brand/sender](https://app.nitrosend.com/my/brand/sender)) and choose where it goes:

- **At the top**: a small link above the email.
- **Beside Unsubscribe**: "View in browser | Unsubscribe" in the footer, in the same style as the Unsubscribe link.

Through the API, set `email_view_online` to `true` and `email_view_online_placement` to `top` or `footer` on `PATCH /v1/my/brands/{sid}`.

The link only appears once its web copy exists: your tracking domain is verified and the campaign has started sending. Previews, test sends and transactional messages never carry it, so no email links to a page that isn't there. An email with no Unsubscribe link gets the link at the top. The web copy is generic, the same page for every recipient.
