Sending email
Choose a sending path that matches the customer moment. Broadcasts reach a defined audience once; templates let your product trigger a saved message for a recipient; workflows send as part of a journey. All use the same composer and the sending mode set on the email.
Templates: send per recipient via the API
A template is saved email content plus a list of the information it needs. You send it from your application with an API call, one recipient at a time. Use it for receipts, password resets, order confirmations, and welcome emails.
When you send, you pass only enough to identify each record, for example { "email": "[email protected]" }. maxclicks finds or creates that contact, reads the full record back, loads the attribute expansions configured for the email, builds the email, and sends it.
Sending a template writes data. Each record you pass in is saved before the email is built, so a send that includes firstName also updates that contact's name.
Broadcasts: mass-send to an audience
A broadcast is a one-time campaign sent to a group at once. Use it for newsletters and announcements. Each broadcast targets one contact schema, then narrows to an audience one of three ways:
- All contacts in that schema.
- A saved segment.
- A custom audience filter you describe in plain language, which maxinja turns into a readable condition.
Then you pick timing. A broadcast is one-time: send now, or schedule for a date and time. There is no recurring schedule. For anything that repeats in response to what people do, use a workflow. The broadcast reference covers composing, audience targeting, scheduling, and the send pipeline.
Understand when a send becomes fixed
A broadcast can prepare messages before its scheduled dispatch time. Preparation fixes the selected recipients and campaign revision; later audience changes do not add customers to that run. Before preparation you can Cancel send and edit again. After it begins, Stop sending permanently cancels remaining work, while messages already being sent may still arrive.
A saved template is different: new requests use the current saved content, with no publication step. Published workflow runs keep the email templates in their version. Review those timing differences before editing a message used in production.
Sent means provider acceptance. Delivery, opens and clicks are later signals. Check the email history before retrying or starting a replacement campaign, especially when acceptance is uncertain.
Marketing vs transactional
Whether an email is marketing or transactional belongs to the content, not to how you send it. You set it on the email itself, so a template, a broadcast, or a workflow can each send either kind. It decides who actually receives the email once consent and suppressions are applied.
| Marketing | Transactional | |
|---|---|---|
| Requires consent? | Yes: subscription and topic | No |
| Skipped on a suppression? | Yes, on any suppression | Only on a bounce suppression |
| Typical use | Newsletters, promotions | Receipts, resets, alerts |
A message to a bare email address, one that is not a contact yet, can only be transactional. Marketing requires a consenting contact behind the address.
Next
Workflows are the third way to send, automatically and in response to events. Continue to the workflows lesson, or open the broadcast reference for the full send setup.