REST API Updates

2021-12 Change in error codes for transactional SMS API

• The case "The message was sent but the statistics are incorrect due to an error" with Application Code = 301 now returns HTTP 200 instead of HTTP 500. More details here

2018-10 Breaking changes

• REST API v. 1.0, mainly used by the previous version of the Salesforce connector, was discontinued on Sep 30th

• Unused developer accounts were discontinued on Sep 30th

• The SOAP API is now marked as "no longer recommended to use if you are starting a new project or planning to extend an existing one". REST API covers the feature set of the SOAP API.

• Access tokens must now be refreshed every hour either for SOAP or REST (it was 15' for the REST API). As the SOAP API is now using the same Authorization methods as the REST API, the expiration of the validity time is now the only way to dismiss a token and to deny the access. Any call to “logout” SOAP methods has become useless.

2018-10 Import by file, content update, privacy settings, and global search

• You can now upload a file via FTP and pass the filename as a parameter to the import REST API for immediate import. This feature allows us to overcome the size limits we have had so far when trying to pass tons on recipients in the request body. With this extension, the MailUp REST API covers the last missing method that resulted when comparing REST and SOAP. More details here.

• Access to the MailUp REST API resources has an improved algorithm for rate limiting. Even though the threshold of 5 calls/s is unchanged, clients exceeding this limit may experience a slightly different error rate. 

• The “global search” of recipients can now be performed by ID, email, or mobile number. A single API call returns both the personal data fields and the subscription status on all the lists and channels. More details here.

• According to the privacy settings introduced with GDPR, you can now use also REST API to fully remove a recipient or to disable tracking for it. More details here.

• External content can now be pushed to MailUp using REST API and then used for automated campaigns or to be easily dragged into your messages. More details here.

2018-03 OAuth 2.0 authorization module reviewed 

• Access to the MailUp REST API resources has an improved algorithm for rate limiting. Even though the threshold of 5 calls/s is unchanged, clients exceeding this limit may experience a slightly different error rate.

• Error code HTTP 429 is now returned instead of HTTP 403 when the rate limit is exceeded. As before, clients have to retry later when this error type occurs

• The email alert at the very first access to API is no more sent to the technical contacts of the accessed MailUp account

• The token type “MailUp” is no longer supported on v.1.1 of MailUp REST API. Clients using this value have to be migrated to the OAuth 2.0 flow using the “Bearer” token

2017-05 Import details, sending history & SMS APIs update

• There are now new methods to retrieve information about the status of an import task, details about a completed task, and a list of all important tasks. More details here.
• With MailUp you can send the same message many times. The SendHistory method now returns both the message ID and the ID of the individual mailings. More details here.
• New methods to retrieve the subscription status of SMS subscribers individually or at the list level, and to perform bulk SMS unsubscribe. More details here.

2017-04 List CRUD, M-list subscription status & SMS credit balance

• There are now new methods that make it easier to manage Lists: quickly create a new List, get all the List details, delete a List that's no longer needed. More details here.
• Need to manage a recipient's subscription status across multiple lists? Now you can check the current status and unsubscribe across lists. More details here.
• Do you use our APIs to send text messages? The updates to the account "details" method now includes a key figure: the SMS credit balance. More details here.

2017-03 Verified FROM emails, send to multiple groups & new import options

• A new method allows you to add a new, verified FROM email. A verification request message is sent automatically to the new address. More details here.
• You can now send a campaign to multiple groups at once, both including and excluding groups for maximum flexibility in segmenting a list. More details here.
• When importing recipients, you now have more options about group(s) assignment. You can also reset a recipient profile (empty fields). More details here.
• New import features (reset group assignments, reset recipient fields) also when importing SMS subscribers. The API has tons of SMS-focused features. More details here.

2015-05 New transactional email API & updated SMTP relay

Great news for those that use MailUp to send transactional emails.

• Check out the new API for sending transactional email messages
• Read about our updated SMTP relay, SMTP+ v2

Lots of new features and substantial performance improvements.

2014-10-14 Confirmed opt-in and scheduled sending added to Version 1.1

What's new

POST Console/List/{ListID}/Recipient?ConfirmEmail=true

POST Console/Group/{GroupID}/Recipient?ConfirmEmail=true

POST Console/List/{ListID}/Recipients?ConfirmEmail=true

POST Console/Group/{GroupID}/Recipients?ConfirmEmail=true

GET Console/Import/{id_import}/Sending

POST Console/Email/Sendings/{id_Sending}/Immediate

POST Console/Email/Sendings/{id_Sending}/Deferred

POST Console/List/{ListID}/Recipients?importType='asOptout' 

GET Console/Email/Sendings/Immediate

GET Console/Email/Sendings/Deferred

GET Console/Email/Sendings/Undefined

GET Console/Email/Sending/{id_Sending}/Deferred

POST Console/List/{id_List}/Email/{id_Message}/Send?datetime='1994-11-05T13:15:30Z'

2013-10-10 Version 1.1 updates

GET - Console/List/{id_List}/Recipient/{id_Recipient}/Groups

GET - Console/List/{id_List}/Archived/Emails

2013-10-10 Version 1.1 has been released

Version 1.1 has been officially released (see changelog) and BETA has been removed. Online documentation is now updated.

2013-07-25 Filtering and ordering coming in v1.1 

How the REST API is evolving

We're already at work on a new version of the REST API.

Version 1.0 of the MailUp REST API is already being used in some integrations, including the MailUp App for Salesforce. We are still optimizing it for big volumes of data (this is the main reason for the BETA tag) and, at the same time, we are working to introduce additional filtering, paging, and ordering capabilities in version "1.1".

Some changes in the API related to these new features will affect backward compatibility, and therefore version 1.1 will be released with a different endpoint.

The expected release date for v1.1 is sometime in September 2013. When version 1.1 is released:

• The MailUp REST API will be OUT OF BETA for both versions 1.0 and 1.1
• If you are using version 1.0, you will be able to continue using it
• Migrating to v1.1 is recommended if you want to benefit from the new features
  

We don't expect that you will be frequently asked to switch endpoint: please consider this as a rare case that is due to the young age of the MailUp REST API project. Future improvements are expected to be applied to version 1.1 without backward compatibility problems.

New features in v1.1

Here is a list of new features that will be available in v1.1:

• Get requests: all the HTTP GET requests that return a collection of items will have a total counter and pagination info alongside the Items collection itself;
• Default pagination values: all the requests that return a collection of items will be paginated by default with a page size of 20…no more entire collection by default,
• Entire collection: if you want the entire collection you’ll have to set up a particular value for pageSize or pageNumber;
• Ordering: with the new release it will be possible to specify complex ordering filters on multiple fields and - if needed - different sorting directions (ex. order by=” id, category-id desc; title asc ”)
• Filtering: new complex query parser will be added to allow developers to filter collections “as they wish” (ex. filter by=”  [idColor==’Blue’ || idColor.Contains(‘Azure’)] && [id <= 30 && id != 10] ”)

2013-07-15 Documentation of REST API v1.0 officially released 

The MailUp REST API documentation is now public.