Import subscribers

Import contacts from a CSV file to a given subscriber list

Endpoint URI

1	`POST https://services.ownpage.fr/v1/files`

Headers

X-Ownpage-Client-Token : a valid token

Payload (JSON)

The data should be a JSON object with the following parameters :

email_list_id : email list where to import contacts
url : public URL of the CSV file to import

CSV file

The CSV file should use , or ; as delimiter and contain the following columns :

email : (mandatory) the user's email address
subscribed : (true|false) the status subscribed/unsubscribed. If not provided or invalid value :
- If the email address is already in your list : the status is not changed
- If not in your list : the address is subscribed
unsubscribed_cause : unsubscription cause (READER: reader decision, PUBLISHER: publisher decision), used when subscribed = false. Default value is READER
guid : the ID of the user in your database. This id must match the one used in navigation tracking. If not provided, the value of the guid is md5(email)
data_* : you can attach additional data to your subscribers using parameters prefixed by data_. Example : data_firstname

Response (JSON)

The response is an object containing the following fields :

id : internal ID for the imported file
name : filename of the imported file
url : URL of the imported file
mediatype : detected mediatype
subtype : detected subtype
created_at : date of the import
size : size of the imported file
status : status of the import
email_list_id : email list where contacts have been imported

Example

curl -X POST --header "X-Ownpage-Client-Token:TOKEN" --header "Content-Type:application/json" --data REQUEST_DATA https://services.ownpage.fr/v1/files

With REQUEST_DATA:

{
    "email_list_id": 123,
    "url": "https://my.domain.com/files/export.csv"
}

Response:

{
    "id": 12,
    "name": "export.csv",
    "url": "https://my.domain.com/files/export.csv",
    "mediatype": "text",
    "subtype": "csv",
    "created_at": "2025-04-02T12:25:01.000Z",
    "size": 142,
    "status": "uploaded",
    "email_list_id": 123
}