Import Email Address Lists

Bulk import email address List Items by uploading a CSV file.

Each row should be the details for a new List Item. The columns we allow are:

value
match_type (either ‘email_address’ or ‘domain’)

A match_type of ‘email_address’ will need to match the entire email address of an individual, while a match_type of ‘domain’ will match on the email address domain of an individual (i.e. all email addresses with domain ‘gmail.com’).

Bulk import email address List Items by uploading a CSV file. Each row should be the details for a new List Item. The columns we allow are: - value - match_type (either 'email_address' or 'domain') A match_type of 'email_address' will need to match the entire email address of an individual, while a match_type of 'domain' will match on the email address domain of an individual (i.e. all email addresses with domain 'gmail.com').

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

includestringOptional

A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details.

fieldsmap from strings to stringsOptional

Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.

Request

This endpoint expects a multipart form.

dataobjectRequired

Response

This endpoint returns an Importer object.

dataobject

An Importer for email address List Items

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

Bulk import email address List Items by uploading a CSV file.

Each row should be the details for a new List Item. The columns we allow are:

value
match_type (either ‘email_address’ or ‘domain’)

Bearer authentication of the form Bearer <token>, where token is your auth token.

Determines casing for the API response.

Ensures the request is idempotent.

Server API version. More info on versioning can be found here.

Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).

A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the included key in the response. See Serialization for more details.

Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See Serialization for more details.

This endpoint expects a multipart form.

This endpoint returns an Importer object.

An Importer for email address List Items

Server API version. More info on versioning can be found here.

A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the included key in the response. See Serialization for more details.

Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See Serialization for more details.

$	curl -X POST https://api.withpersona.com/api/v1/importer/list-item/email-addresses \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: multipart/form-data" \
>	-F data='{
>	"attributes": {
>	"file": "string",
>	"list-id": "string"
>	}
>	}'

1	{
2	"data": {
3	"id": "mprt_TKqquVbHaSVYqgWhxNjuYDjQ",
4	"attributes": {
5	"created-at": "2020-07-12T17:16:54.656Z",
6	"duplicate-count": 0,
7	"error-count": 0,
8	"status": "pending",
9	"successful-count": 0
10	},
11	"type": "importer/list-item/email-address"
12	}
13	}

Import Email Address Lists

Authentication

Headers

Query parameters

Request

Response

Errors

Authentication

Headers

Query parameters

Request

Response

Errors