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"=>"<string>", "records"=>"<string>", "list_type"=>"EMAIL"}

HEADERS

RESPONSES

status: OK

{"ad_account_id":"\u003cstring\u003e","created_time":"\u003cnumber\u003e","id":"\u003cstring\u003e","name":"\u003cstring\u003e","num_batches":"\u003cnumber\u003e","num_removed_user_records":"\u003cnumber\u003e","num_uploaded_user_records":"\u003cnumber\u003e","status":"PROCESSING","type":"\u003cstring\u003e","updated_time":"\u003cnumber\u003e","exceptions":{}}