Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Getting started

  1. Read our best practices to understand what you can do and learn the recommended approaches.

  2. Download Demo Client and choose among several available programming languages.

  3. Test Resource Access with your MailUp account. Don't have one? Request a developer account.

  4. After getting acquainted with the API, get your

own  and
  1.  & build your own application.

Integrating your application

A few things to keep in mind:

  • The MailUp REST API uses Oauth2 and requires a token refresh. You can use the available samples to see how to refresh the authorization token

  • By properly setting the request header you can set the response format as JSON or XML

  • Each application is tied to a set of application keys, which are used to authorize the application (get yours).

  • Users of the application will be authenticated using their own MailUp account credentials.
  • The application keys used in the
MailUp Demo Clients
  • sample code shall not be used in a production environment.
Obtain your application keys by activating a free developer account.
  • Each application is tied to a set of application keys (but not to a specific MailUp account: it can be used with any MailUp account)

  •  


    Tip
    titleGetting stuck while developing your application?

    Take another look at the "Getting Started" section: the demo client can help a lot. Also, before contacting us, please consider that most of the questions that we receive are about...

    Authentication (
    • .

    • Wrong credentials (e.g. trying to access to your production

    console
    • account with the credentials of your developer

    console
    • account, or viceversa).

    • Unexpected behavior of an API call due to unchecked error codes that were returned by previous API calls.

    • Developers that are unfamiliar with MailUp terminology (Resource Access section and related links should be helpful).


    A complete email messaging API

    When to use the MailUp REST APIThe MailUp REST API gives you access to a variety of methods to manage email campaigns, subscribe and unsubscribe recipients, and retrieving statistics, bounces, etc. 

    Recipient management

    Message management

    Campaign management

    Statistics retrieval

    Account provisioning

    Import recipients, get import status

    Retrieve lists, groups, email messages, etc.

    Subscribe, unsubscribe, update recipients

    Create and modify groups

    ...See Manage Lists and Groups and Recipients

    Create, modify, delete a message

    Create a message from a template

    Retrieve a list of messages

    Add and remove images

    ...See Email

    messages#Emailmessages

    messages

    Send a message to a List

    Send a message to a Group

    Send a message to a Recipient

    ...  See 

    Email messages#SendEmailMessages

    Send Email Messages

    and also Transactional Emails

    Retrieve details on sent messages 

    Retrieve opens, clicks, bounces, unsubscribes

    Retrieve stats for the last N hours

    Retrieve stats for a specific period

    ...See Email Statistics

    Request new free trial account

    Obtain request status

    ...See Accounts


    Info

    Before choosing the REST API as the technical solution for integrating your application, ensure that you have read our best practices

    Latest news

    Recently added methods >

    Related resources

    children

    .