| Tip | ||
|---|---|---|
| ||
Click here to learn more about the difference between lists and groups in MailUp. |
...
| Note |
|---|
It is recommended that you do not create a new list for each campaign, to avoid performance issues we suggest you to not exceed the limit of 100 lists for each console account. |
...
Lists
Note: methods for creating, updating and deleting MailUp lists through REST API are not yet available
...
| Description | Return the lists that are visible for authenticated user. If an existing list is not returned it is likely that the MailUp specified with the API is not enabled to see that list. Users with administrators grants can change this setting using the admin console account (i.e. the web application) | |||||||
|---|---|---|---|---|---|---|---|---|
| HTTP Method | GET | |||||||
| URL | https://services.mailup.com/API/v1.1/Rest/ConsoleService.svc/Console/User/Lists | |||||||
| JSON request (example) | none | |||||||
| JSON response (example) |
| |||||||
| Paging and filtering (example) | 5 items per page, get first page (count starts from zero)
Retreive all the lists whose name contains 'Newsletter' filterby="Name.Contains('Newsletter')" and sort them by ID orderby="idList desc". Parameter names can be retreived from the response body. Please note that "Contains" is case sensitive.
|
Add recipients to a list (subscribe)
...
- add and subscribe one or more recipients. See "Import recipients".
- force subscription of an existing recipient (i.e. unsubscribed or pending) by specifiying its ID. Refer to "Update subscription"
Remove recipients from a list (unsubscribe)
REST API does not include yet a method for bulk unsubscription, while the unsubscription of a single recipient by specifying its ID is available. Refer to "Update subscription"
...
Groups
Create Group
Description | Create a group into the specified list. Group ID is returned | |||||
|---|---|---|---|---|---|---|
HTTP Method | POST | |||||
URL | https://services.mailup.com/API/v1.1/Rest/ConsoleService.svc/Console/List/{ID_LIST}/Group | |||||
JSON request (example) |
| |||||
JSON response (example) |
| |||||
Paging and filtering (example) | none |
...