Page tree

Versions Compared


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


  • already subscribed remain subscribed
  • pending or unsubscribed on SMS channel do not change their subscription status

 The import process is able to recognize existing recipients, using the mobile number as unique identifiers, and update them according to the given input details. It is possible to add some querystring parameters to specify some advanced behavior for the import process:

  • clearMissingOrEmptyFields: if specified, the import process updates to empty every missing or empty field contained in the request body.
  • removeFromPrevGroups: if specified, the import process removes the given recipients from current groups and it adds them to that specified in the request. The querystring parameter can be used only in import to group calls.


Asynchronous import of one or more recipients on SMS channel

HTTP Method



Code Block
titleAdd to a MailUp list{id_List}/Recipients
Code Block
titleAdd to a MailUp group{id_Group}/Recipients

 Go to automated doc

titleClick here to learn more about request parameters

Request is composed of a list of comma separated objects, each one of them is composed of the following mandatory fields:

Field NameTypeDescription

Array of objects [0..39].
Each object is composed of
the following fields:  

  • Description (String, optional)
  • Id (Integer, from 1 to 39)
  • Value (String)


Each array object is a personal data field.

If recipient is already existing, the "fields" values can be used to update recipient's personal data

NameStringNot used but required, it can be empty (i.e. "Name":"")
MobileNumberStringNumber format is checked by an asynchronous process, hence in case of invalid number import fails but no error is returned

International prefix. Allowed formats are:

  • prefix with 00 (e.g. "0039")
  • prefix with + (e.g. "+39")
  • empty prefix (e.g. "", default list prefix is applied)


JSON request (example)

Code Block
             "Description":"String content",
             "Value":"String content"
  "Name":"String content",

JSON response (example)

Returns import ID



Paging and filtering (example)