> For the complete documentation index, see [llms.txt](https://docs.boomerangme.cards/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.boomerangme.cards/mailings-and-other-services/how-to-create-and-send-a-mailing.md).

# How to create and send a mailing

The new mailing section is located near the "Send Push" section.

In it you can create mailings to your clients by email and sms.

To make the mailing function available, you need to connect your messaging services in the settings: Twilio for SMS, and Mailgun, SMTP, or SendGrid for email.

<figure><img src="/files/7sHoeupDYIhE5vcDQ8qX" alt=""><figcaption></figcaption></figure>

Now let's go back to the mailing section and create mailing.

In actions select create mailing.

In the modal window enter the name of the mailing and select the type: email and/or sms.

Click "Create mailing".

<figure><img src="/files/tqB46YjACRS7eT5TQ8mk" alt=""><figcaption></figcaption></figure>

In the next window you can select the recipients of the mailing: it can be all your customers or only customers from a certain segment.

<div><figure><img src="/files/Ip6RLXbXMiiBNrvHMpbt" alt=""><figcaption></figcaption></figure> <figure><img src="/files/tjNSgE55v2brPb9D1Y0G" alt=""><figcaption></figcaption></figure></div>

You can also send the mailing immediately after creation, or you can schedule it. To do this, you need to select the Schedule checkbox and choose the date and time of the mailing.

We can use emoticons and placeholders.&#x20;

<figure><img src="/files/HnMqDRWKbdJw97UnHj6b" alt=""><figcaption></figcaption></figure>

Placeholders allow you to make messages unique for each recipient.  You can expand the placeholders sections and select the desired card.  

<figure><img src="/files/dNhlr8NboimU6zFYGVbD" alt=""><figcaption></figcaption></figure>

### Personalized card install link in mailings

When creating a mailing, you can select a specific card template — the system will automatically include a personalized install link for that template in the message.

This is especially useful if your account has multiple loyalty programs (e.g., a stamp card and a cashback card). Instead of sending a generic install URL, you can target each customer with a direct link to install the specific card they don't have yet.

For example, if a customer already has a stamp card but hasn't installed your cashback card, you can create a mailing that includes a personalized install link specifically for the cashback card. This allows you to run targeted campaigns to cross-promote your loyalty programs and increase card adoption across your customer base.

When the text of the mailing is ready, click the "Create mailing". Now our mailing appears in the list.&#x20;

To get detailed information click on the name of the mailing.

<figure><img src="/files/XGq1JoOVhBZ2ZT5FL0vt" alt=""><figcaption></figcaption></figure>

&#x20;This page shows information about the mailing, as well as sending statuses for each recipient.

#### Mailing Templates

Boomerangme gives you full flexibility to compose your own mailing messages from scratch. You can create any text content, use placeholders for personalization, add emojis, and adjust the formatting to match your brand's tone and communication style. This way, every mailing you send is fully customized and reflects your brand's message.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.boomerangme.cards/mailings-and-other-services/how-to-create-and-send-a-mailing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
