Send a message

Send emails to recipients

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
ℹ️

This API endpoint is only available for customers with Splio Edition 2025 .

⚠️

While transactional communications are permitted on messaging-api, we strongly recommend obtaining your customers’ consent before sending transactional messages. Selecting this option means you take full responsibility for contacting anyone who may not have opted in to receive the communication.

This endpoint allows you to send messages, whether for marketing campaigns or transactional notifications, through the email channel. With this feature, you can effortlessly reach your target audience and engage with them effectively.

Whether you need to send a single message or a batch of messages, this API endpoint provides you the flexibility and convenience to manage your email communication seamlessly.

You can also personalize the emails by using data stored in our database or passed in the payload. It allows you to tailor your messages to each recipient, enhancing the relevance and impact of your email campaigns.

For example if you have this in your payload

{
  "variables": {
  	"total_vat": 100, 
    "vat_rate": 20
  }
}

You can use it directly as a liquid variable

Total included tax <b>{{total_vat}}</b> ({{vat_rate}}%)
Body Params
string
enum
required

Today, only the email channel is upported.

Allowed:
string

This key must be used if you want to avoid duplicates. When receiving 2 calls with the same idempotency key, we refuse the second call. Can also be used by the sender to identify a specific message.

properties
object
required
recipients
array of objects
required

Recipients type must be coherent within a same call. The first recipient type matched is considered as the one used for all the recipients.

recipients*
boolean

When 'true', the message will be considered as transactional. It means that it will bypass some optins and blacklists. Warning: in the case of a marketing message, you cannot communicate with a contact which is not optin, and so not use this option.

metadata
object

Those metadata are used to aggregate the events for statistics purposes

variables
object

Those variables will be applied to all the messages in this sending. They are used to personalize the messages but won't modify the contacts in database.

Responses

Language
Credentials
Bearer
token
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json