This doc provides recipes for populating lists via API. Note that lists can also be created and edited in the Persona dashboard.
Learn more in the Lists API documentation
First, create the list:
To add one email address at a time, use the Create an Email Address List Item API.
To import many email addresses at once, upload a CSV of your email address data via the importer API:
The CSV should contain the following fields:
email_address or domain)A match_type of email_address will only match the entire email address of an individual, while a match_type of domain will match any email address with the specified domain (i.e. all email addresses with domain ‘gmail.com’).
Here’s an example CSV:
First, create the list:
To add one geolocation at a time, use the Create an Geolocation List Item API.
To import many geolocations at once, upload a CSV of your geolocation data via the importer API:
The CSV should contain the following fields:
Here’s an example CSV:
First, create the list:
To add one government ID number at a time, use the Create an Government ID Number List Item API.
To import many government ID numbers at once, upload a CSV of your government ID number data via the importer API:
The CSV should contain the following fields:
Here’s an example CSV:
Common values for id_class include ‘pp’ for passport and ‘dl’ for driver license. Please contact us if you need help getting id_class values!
First, create the list:
To add one IP address at a time, use the Create an IP Address List Item API.
To import many IP addresses at once, upload a CSV of your IP address data via the importer API:
The CSV should contain the following fields:
Here’s an example CSV:
Both IPv4 and IPv6 are supported.
First, create the list:
To add one name at a time, use the Create a Name List Item API.
To import many names at once, upload a CSV of your name data via the importer API:
The CSV should contain the following fields:
Here’s an example CSV:
First, create the list:
To add one phone number at a time, use the Create a Phone Number List Item API.
To import many phone numbers at once, upload a CSV of your phone number data via the importer API:
The CSV should contain the following fields:
Here’s an example CSV: