> ## Documentation Index
> Fetch the complete documentation index at: https://help.ciarem.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Email campaigns

> Send one email to many contacts from your connected mailbox, and see who got it, replied or unsubscribed.

An **email campaign** is one email sent to many contacts at once from your connected [email](https://help.ciarem.ai/channels/email.md) mailbox: a newsletter, an offer, a "we're open again" announcement. Replies land in your [Inbox](https://help.ciarem.ai/using-ciarem/inbox.md) like any other email, and your AI agent or your team answers them.

## Before you start

* Only **admins** can write templates and send campaigns, and only on the **web app**, not the mobile app.
* You need a connected mailbox on **Gmail / Google Workspace** or **Microsoft 365**. See [Email](https://help.ciarem.ai/channels/email.md) to connect one.

## Write a template

An **email template** is the email itself: you write it once and send it as many times as you want. Go to **Channels**, then **Email**, and click **View templates** on the **Templates** card. The **Templates** button on the Campaigns page opens the same list. It is a table with each template, its subject, who created it and when it was last edited.

**1. Create the template**

Click **New template**. Fill in the **Template name**, the **Subject** and the **Preview text**, the line most inboxes show next to the subject.

**2. Write the message**

Use headings, **bold**, *italic* and underline, links, lists, a divider and buttons, and pick the **Button color**. Images can be PNG, JPEG, GIF or WebP, up to 5 MB each. Outlook on the desktop shows WebP poorly, so prefer PNG or JPEG.

**Insert contact field** adds a merge tag such as `{{contact.first_name|there}}`. The text after `|` is used when the contact has no value, so a contact with no first name reads "there". It is the same variable WhatsApp templates use, with the fallback added. The menu also offers the contact's company (`{{company.name}}` and the other company fields, from the contact's primary company, with the [Companies](https://help.ciarem.ai/using-ciarem/companies.md) add-on on) and the name of the person sending (`{{agent.first_name}}`, `{{agent.last_name}}`, `{{agent.name}}`): in a campaign, whoever created it; in a test email, you.

**3. Preview and test**

The preview shows the email at **Desktop** and **Phone** width, with the fields as written (`{{contact.first_name|there}}`). **Send test** sends it to you the same way a campaign goes out (through the mailbox, or through your [sending domain](#verify-a-sending-domain) once it is verified), so you see exactly what your contacts will get.

With several mailboxes connected, **Preview and test from** chooses which mailbox the preview and the test use. The template itself belongs to no mailbox.

**4. Save it**

Click **Save**. The template is now in the **Templates** list. Click its row to edit it; the row's ⋯ menu has **Edit** and **Delete template**. Editing or deleting a template never changes campaigns already sent with it.

## Send it

You choose the contacts first, then the template.

**1. Choose the contacts**

A send always starts from a selection:

* **Contacts**: select the contacts (one by one, or all of them on a filtered list or on a segment's page) click **Send** in the selection toolbar and choose **Send email**. The same menu has **Send WhatsApp template**. On the Contacts board, a column's menu also has **Send email**. On **Companies**, select companies and click **Email contacts**: the email goes to those companies' contacts.
* **Everyone, or a saved view**: open **Contacts** (with the saved view applied, if you want one), select all and choose **Send email**. The **Campaigns** page lists your sends but doesn't start one.

**2. Pick the template**

In the **Send email** dialog, choose the **Template**, and the mailbox under **From** when several are connected. A preview of the email appears beside it, with the fields as written; pick one of the contacts it goes to under **Preview as** to see the email as they get it, signed by you.

**3. Check, then send or schedule**

Click **Send now**, or **Schedule** to pick a date and time. Before anything goes out, Ciarem shows the check described below. Confirm it to send. You stay on the page you were on, and a notice offers **View campaign**.

## The check before sending

The last step shows:

* How many contacts will **receive it**.
* Who is **left out**: contacts with no email address, contacts who unsubscribed, contacts whose email bounced before, and contacts with no record of consent. On a sending domain's first campaign, also contacts who haven't written to you in the last 90 days.
* How it is sent: **Sent from your mailbox**, or **Sent through SES from** your domain.
* How many emails you can still send **today**.
* Contacts **missing a field** your message uses. They see the fallback text, or nothing.

### Consent

A contact has a record of consent when they emailed your business, or when you marked them as consented on their contact page (**Mark as consented**). Contacts without one are left out by default. You can turn on **Include contacts with no record of consent** for one campaign, on your own responsibility: only do it if they know your business and expect your email.

Before your first campaign, Ciarem asks you to confirm once, for your organization, that the list was not bought or rented, and that the people on it have a relationship with your business or agreed to get its email.

## Limits and price

* Up to **100 recipients per organization per day**, across all campaigns sent through a mailbox. Campaigns from a verified domain have their own limit: see [Sending to more than 100 a day](#sending-to-more-than-100-a-day).
* From a mailbox, emails go out gradually, up to 20 per minute from each mailbox. If your email provider slows sending, the campaign pauses for 10 minutes and resumes on its own. If it happens three times in a row, the campaign stops and the contacts not yet reached are skipped; send the template again later to a smaller audience.
* A campaign bigger than what is left of today's allowance can't be sent. Pick a smaller audience, or schedule it for another day.
* Each email a campaign sends counts as **one message of your plan**, like any message Ciarem sends: it uses your monthly allowance first, then each one is billed at your plan's rate (**Settings > Billing**). Bounced emails count as sent. It's the same when the campaign goes through your sending domain.

## Track it

Every send is listed on the **Campaigns** page with its status: **Scheduled**, **Sending**, **Sent**, **Stopped** or **Failed**. A campaign keeps its own copy of the email it sent. Open one to see how many emails were **Sent**, **Bounced**, **Unsubscribed** and **Replied**. Campaigns sent through your sending domain also show **Delivered**, **Opened**, **Clicked** and **Marked as spam**. The **Recipients** tab lists every recipient, with a link to their contact and to their conversation.

To stop a scheduled or sending campaign, open it and click **Stop**. Emails already sent stay sent; contacts not reached yet are skipped.

## After the send

* **Replies**: a reply lands in the Inbox as a normal email conversation, with the campaign shown above it. Your AI agent or your team answers as usual. Out-of-office replies don't create conversations.
* **Unsubscribes**: every email has an unsubscribe link, and Gmail and other providers also offer a one-click unsubscribe. A contact who unsubscribes never gets another campaign, but you can still reply to them one to one. Their contact page shows **Unsubscribed**. Only an admin can undo an unsubscribe, and a spam complaint can't be undone.
* **Bounces**: an address that fails for good is marked as bounced and left out of later campaigns. Changing the contact's email clears it.
* **Send it again**: to send the same email to a new audience, send its template again. On a campaign's page, **Save as template** turns that campaign's content back into a template, which helps when the template was changed or deleted since. A campaign that failed or was stopped can't be sent again as it is; send the template again instead.

## Verify a sending domain

To send campaigns from your own domain (for example `acme.com`), verify it once. Only admins can do this, on plans that include email campaigns.

Sending from your own domain isn't open to every workspace yet. If the Email page has no **Sending domain** card, your campaigns go out through the connected mailbox.

**1. Add the domain**

Go to **Channels**, then **Email**. In the **Sending domain** card, type your domain and click **Add domain**.

**2. Add the DNS records**

Ciarem shows four records. Add them where you manage your domain's DNS (usually where you bought the domain), using **Copy name** and **Copy value**:

* Three **DKIM** records, of type **CNAME**.
* One **DMARC** record, of type **TXT**, on `_dmarc` and your domain. `v=DMARC1; p=none;` is enough. If your domain already has a DMARC record, it counts.

**3. Wait for the check**

Ciarem checks the records every 5 minutes, or right away when you click **Check now**. Each record shows **Found** once Ciarem sees it, and when they are all found the domain shows **Verified**. DNS changes can take a few hours to show up.

* A domain not verified within **72 hours** shows **Failed**. Remove it, then add it again and check its records.
* **Gmail, Outlook** and other free addresses can't be verified. Campaigns from them go through the mailbox, up to 100 a day.
* A domain can be used by only one organization.
* To stop using a domain, click **Remove**. You can't remove it while a campaign from it is scheduled or sending.

## Sending to more than 100 a day

Once your domain is verified, every campaign **from a connected mailbox whose address is on that domain** (for example `news@acme.com`) goes out through SES, Amazon's email service, instead of through the mailbox, with no 100-a-day limit. You don't have to choose anything: the check before sending shows **Sent through SES from** your domain. Campaigns from any other mailbox go through the mailbox, as before. Replies still arrive in the mailbox and in your Inbox.

* **Warm-up**: email providers trust a new sender gradually, so a new domain starts at **500 recipients a day**, counted across all its campaigns that day (UTC). The limit doubles, at most once a day and up to **50,000**, about 6 hours after a campaign that reached at least half of the limit with few bounces and spam complaints. The check before sending shows the limit, what is left today, and when it grows next.
* **First campaign**: a domain's first campaign goes only to contacts who wrote to you on any channel in the last 90 days. The check shows how many are left out (**Haven't written in 90 days**).
* **More results**: these campaigns also show **Delivered**, **Opened**, **Clicked** and **Marked as spam**. A contact who marks a campaign as spam is unsubscribed from campaigns.
* **Protecting your domain**: once a domain has sent 200 emails in the last 7 days, more than **3%** bounces or more than **0.05%** spam complaints (including Gmail's spam rate) pause it. Its campaigns stop, contacts not reached yet are skipped, and your admins get an email. No campaign can be sent from the domain until Ciarem's team lifts the pause: write to support. A paused domain can't be removed.
* **Price**: the same, **one message of your plan** per email sent.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.