Create customer lists

POST {{baseUrl}}/ad_accounts/:ad_account_id/customer_lists

Create a customer list from your records(hashed or plain-text email addresses, or hashed MAIDs or IDFAs).

A customer list is one of the four types of Pinterest audiences: for more information, see Audience targeting or the Audiences section of the ads management guide.

Please review our requirements for what type of information is allowed when uploading a customer list.

When you create a customer list, the system scans the list for existing Pinterest accounts; the list must include at least 100 Pinterest accounts. Your original list will be deleted when the matching process is complete. The filtered list – containing only the Pinterest accounts that were included in your starting list – is what will be used to create the audience.

Note that once you have created your customer list, you must convert it into an audience (of the “CUSTOMER_LIST” type) using the create audience endpoint before it can be used.

Request Body

{"name"=>"The Glengarry Glen Ross leads", "records"=>"email1@pinterest.com,email2@pinterest.com,..<more records>", "list_type"=>"EMAIL"}

HEADERS

RESPONSES

status: OK

{"ad_account_id":"549756359984","created_time":1452208622,"id":"643","name":"The Glengarry Glen Ross leads","num_batches":2,"num_removed_user_records":0,"num_uploaded_user_records":11,"status":"PROCESSING","type":"customerlist","updated_time":1461269616,"exceptions":{}}