Import methods

Provides operations for creating, making requests on, and deleting Imports in Queue.

  • CreateImportByCsv

    Batch import multiple subscribers using a CSV formatted file. NB! There is a file size limitation of 100 Mb so files larger than that should be in .zip format. Also note that the method will return the Import ID, and the status of the import can later be polled using the GetImportStatus method. Click here for detailed explanation of format and considerations. External files are downloaded asynchronously. They should thereby be kept at their location until the GetImportStatus method reports that the import is completed. Use DemographicDataMapping parameter to selectively specify import file columns from 7 to 107 to map to demographic data fields from 1 to 100. If DemographicDataMapping is provided, not mapped demographic data fields will not be imported.

    2015-12-07 v3: Updates to do asynchronous download of external file for increased API performance. External files should now be kept at their location until the import is completely done.

    2016-06-15 v4: Introduce DemographicDataMapping parameter for mapping import file columns to demographic data fields.

  • CreateImportByXml

    Batch import multiple subscribers using XML-data. NB! It is recommended that each batch should not be larger than around 2 000 subscribers (there is a file size limitation of 5 Megabyte in place that could cause large batches to fail). 'XmlData' containing data about imported subscribers in XML format, should be properly encoded depending on request format. See request body examples. The method requires use of demographic name mapping. Please read more by clicking here .

  • GetImportIgnoredDuplicates

    Gets the list of duplicate email addresses for a given import, which are ignored in the import process. History is kept for 30 days, after which it is deleted.

    2015-12-29 v2: (first version is v2)

  • GetImportInvalidEmails

    Gets the list of invalid email addresses for a given import. History is kept for 30 days, after which it is deleted.

    2015-12-29 v2: (first version is v2)

  • GetImportRecipientsOnOptOutAll

    Gets the list of Opt-Out all email addresses for a given import. History is kept for 30 days, after which it is deleted.

    2015-12-29 v2: (first version is v2)

  • GetImportRecipientsOnOptOutList

    Gets the list of Opt-Out list email addresses for a given import. History is kept for 30 days, after which it is deleted.

    2015-12-29 v2: (first version is v2)

  • GetImportResults

    Gets the result for a given import

    2015-12-29 v2: (first version is v2)

  • GetImportStatus

    Gets the status of the import that has been previously added to the importer queue.

    2015-12-29 v2: In V2 it gives more detailed response. For failed imports, the response contains the failure code and the failure message .