Versions Compared

Key

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

On this page:

...

DescriptionReturn 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 MethodGET
URLhttps://services.mailup.com/API/v1.1/Rest/ConsoleService.svc/Console/List
ReferenceGo to automated doc
JSON request (example)none
JSON response (example)
Expand
Code Block
languagehtml/xml
{
  "IsPaginated": false,
  "Items": [
    {
      "Company": "",
      "Description": "",
      "IdList": 23,
      "ListGuid": "2bb7ad3d-6f4f-4526-b35f-aea9e912097f",
      "Name": "New Arrivals"
    },
    ...
    {
      "Company": "",
      "Description": "Iscritti alla newsletter. Si possono creare infinite liste, ad esempio per tipologie di newsletter, per società...",
      "IdList": 1,
      "ListGuid": "aafa5375-bcf1-4e06-965a-e3a98b626156",
      "Name": "Newsletter"
    }
  ],
  "PageNumber": 0,
  "PageSize": 20,
  "Skipped": 0,
  "TotalElementsCount": 6
}
Paging and filtering (example)

5 items per page, get first page (count starts from zero)

Retreive the list(s) whose name exactly matches the string 'Newsletter' using filterby="Name=='Newsletter'" then sort them by ID with orderby="idList desc". Parameter names can be retreived from the response body. Please note that filter matching is case sensitive.

Please note that also filtering with "Contains" is allowed but == is much more performing.

...

  • 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

...