Recommended authentication method
We recommend authenticating with OAuth v2. To do so:
- Register your OAuth application to get a "Client ID" and a "Client Secret" key. Please see below How to obtain your API keys.
- Sign up for a MailUp account (either a free trial or a full account) and select a user that has enough permissions within the MailUp admin console so to access the resources that you need to use.
- Develop your OAuth-based client application and connect it to MailUp. Samples and wrappers are available here.
When users of your application first connect to MailUp, they will be asked to enter their MailUp account credentials. After that, the next iterations will be performed by exchanging access tokens. For more details on how the authorization and authentication process works, /wiki/spaces/mailupapi/pages/36340583.
How to obtain your API keys
Get a Developer Account
To obtain a "Client ID" and a "Client Secret", request a MailUp Developer account.
Obtain API Keys
Log into your MailUp Developer Console and click on the "Developer" tab in the navigation. You can now request your MailUp API keys by pressing the "+" button and filling out the form.
You wil be asked to fill out a brief form.
Press the "Request keys" button. Your request will be processed and your application will be available in the "Integrations" page (Account Settings > Developer's Corner > Integrations). There you will be able to access your API access keys, as shown in the screenshot below.
Publish your application to the MailUp Integrations catalog
Once you have completed work on integrating your application with the MailUp platform, you can submit it to our team by clicking on the "Request publication" button.
The MailUp team will review your work and - if approved - your application will become visible on the Integrations page of all MailUp accounts.