Import addresses from a CSV file. Each new one gets a confirmation email and receives nothing until it confirms. Confirmations beyond the hourly limit are queued and go out later.
POST
/status_page/{status_page_id}/subscriber/import
const url = 'https://api.siteqwality.com/status_page/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/subscriber/import';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"csv":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.siteqwality.com/status_page/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/subscriber/import \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "csv": "example" }'Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” status_page_id
required
string format: uuid
Status page identifier
Request Body required
Section titled “Request Body required ” Media type application/json
object
csv
required
CSV text. A header row naming an email column picks that column; without one, each row’s
first cell holding an @ is the address. One address per line works too.
string
Example generated
{ "csv": "example"}Responses
Section titled “ Responses ”What each row came to
Media type application/json
object
rows
required
Every data row, in file order.
Array<object>
object
row
required
The row’s record number, counting a header row as 1: the row a spreadsheet shows, which differs from the file line once a quoted cell holds a line break.
integer
email
required
string
result
required
What one address in an import came to.
string
counts
required
How many rows came to each result.
object
confirmation_sent
required
integer
queued
required
integer
already_subscribed
required
integer
already_pending
required
integer
quarantined
required
integer
invalid
required
integer
duplicate
required
integer
page_full
required
integer
sends_per_hour
required
The most confirmation emails an import sends for one page in an hour.
integer format: int64
Example
{ "rows": [ { "result": "confirmation_sent" } ]}No addresses, or more than 1000 rows
Missing or invalid authentication
Status page not found
Another import or sign-up is in progress
Internal server error