API / Import

Method	Endpoint	Description
GET	api/import/subscribers	Gets a import statistics.
GET	api/import/subscribers/logs	Get a import statistics .
POST	api/import/subscribers	Upload a ZIP file or CSV file to bulk import subscribers.
DELETE	api/import/subscribers	Stops and deletes a import.

GET api/import/subscribers

Gets import status.

Example Request

curl -u "username:username" -X GET 'http://localhost:9000/api/import/subscribers'

Example Response

{
    "data": {
        "name": "",
        "total": 0,
        "imported": 0,
        "status": "none"
    }
}

GET api/import/subscribers/logs

Gets import logs.

Example Request

curl -u "username:username" -X GET 'http://localhost:9000/api/import/subscribers/logs'

Example Response

{
    "data": "2020/04/08 21:55:20 processing 'import.csv'\n2020/04/08 21:55:21 imported finished\n"
}

POST api/import/subscribers

Post a CSV (optionally zipped) file to do a bulk import. The request should be a multipart form POST.

Parameters

Name	Parameter type	Data type	Required/Optional	Description
params	Request body	String	Required	Stringified JSON with import params
file	Request body	File	Required	File to upload

params (JSON string)

    {
        "mode": "subscribe", // subscribe or blocklist
        "delim": ",",        // delimiter in the uploaded file
        "lists":[1],         // array of list IDs to import into
        "overwrite": true    // overwrite existing entries or skip them?
    }

DELETE api/import/subscribers

Stops and deletes an import.

Example Request

curl -u "username:username" -X DELETE 'http://localhost:9000/api/import/subscribers' 

Example Response

{
    "data": {
        "name": "",
        "total": 0,
        "imported": 0,
        "status": "none"
    }
}