Guides

Sending Emails

Design and send emails with Nitrosend

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 explains those requirements and how to investigate accepted mail that reaches Junk.

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)
  2. Choose a template or start from scratch
  3. Select your audience (a contact list or segment)
  4. Preview, test, and send

Transactional messages

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

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.

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.

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

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

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), or set email_track_opens or email_track_clicks to false on PATCH /v1/my/brands/{sid} (see the API Reference). 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 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: support deletes the recorded events for the tracking you turned off, segment engagement is rebuilt without them, and aggregate counts stay.

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