if your use case is at least one of the following:
Yes. You can do some occasional bulk mailing if it is compliant with the terms and conditions accepted by your recipients, but this should be a rare exception.
Instead of using Transactional APIs, it is recommended you use the specific methods for sending email/SMS campaigns (see docs). For your marketing campaigns we recommend you do a bulk mailing in one of the following ways:
Email and SMS
No, each channel has its own endpoint and request format.
Email: please note that free trial accounts are limited to 25 messages sent per month. Once you become a paying customer, your sending speed and volume will be limited by the message frequency that you have purchased (e.g. 5,000 messages per hour). See MailUp pricing for more.
SMS: sending is based on credits. Requests fail if there is not enough credit left
It's your choice. You can send transactional emails with MailUp in two ways:
They provide virtually the same features. In addition, performances, scalability, the aggregation policies and the usage restrictions (i.e. do not use it for promotional emails) of the APIs are exactly the same as the ones enforced for SMTP+. In fact, the two solutions share the backend architecture and the user authorization modules.
The main differences are the following:
Yes, the transactional API fully cover the feature set of the methods listed below. In addition, the transactional API have to be preferred to the methods they replace, either because of their better performance of because SOAP API could be deprecated soon.
Channel | Replaced SOAP methods |
---|---|
SendSingleNewsletter | |
SMS | SendSingleSms SendDirectSMS |
Some preliminary tasks have to be performed the very first time to setup a transactional channel.
Email: you have to create a SMTP+ user to be referenced when invoking the mailing methods. SMTP+ users can be created through the MailUp web application or using the REST API. In both cases, first you have to authorize a trusted sender, then you can create a new user and get its credentials. Please refer to #Link1 and #link2 for the REST API methods. Once you have an enabled user, you can start sending transactional emails.
SMS: an additional API key (aka "ListSecret") has to be generated through a specific API for each MailUp list to be enabled for transactional SMS. Please refer to link#3 to learn how to set and get this key. Once you have the API key value, you can start sending transactional SMS.
Channel | Methods | Reference | Returned values | |
---|---|---|---|---|
| Transactional Emails using APIs | Error codes | ||
SMS |
| Transactional SMS using APIs | Delivery ID |
Here is a short list. Please refer to the API documentation for all the details.
Main request parameters | Main options | Advanced options |
---|---|---|
|
| |
SMS |
|
|
*the campaign code is an ID that MailUp uses to group the mailing results by the specified ID.
For each new ID, MailUp creates a "message" object, which will act as result container
Depending on the invoked method, different authentication types are required.
Channel | Operation | Authentication type |
---|---|---|
Setup | OAuth 2 | |
Send message | SMTP+ credentials in the request body | |
SMS | Setup | Basic Authentication |
SMS | Send message | API key |
Yes, all the methods can be invoked using only HTTPS (port 443)
Email: There could be cases in which, due to the purchased frequency and to a FIFO (first-in, first-out) approach, some urgent messages could be delayed by other outgoing messages, like large campaigns that are already in progress. In this cases you need to set a different priority for delivery. Please note that the “priority” value that can be set through the user interface for each SMTP+ user could be misleading. It is just an additional information that some email clients use when displaying the message summary. This setting cannot be used by MailUp to move forward or behind the messages within a delivery queue. If you have mailings with different priorities in terms of delivery (e.g. password reminders have to be very quick, while standard notifications could take longer) you may need a special configuration (aka “fast”) to be set to one or more of your SMTP+ users. Messages sent through the “fast” SMTP+ user use a separate queue. If you send only really urgent messages through this second queue the delivery is likely to be extremely fast. The “fast” configuration is a custom setting, not related to the “priority” value described above. Please contact your MailUp representative to check if it is applicable to your account and if there is an additional cost.
SMS: Unlike the email channel, there is not a guaranteed minimum speed for SMS, which are delivered as fast as possible. All the messages are sent according to the FIFO policy. If all the SMS you are sending through your MailUp account are transactional and you are not happy with the current delivery speed you may contact MailUp support and ask a quote for the special route that is reserved for OTP traffic.
Channel | Result Types | Sample code | |||||
---|---|---|---|---|---|---|---|
|
| ||||||
SMS |
|
|