Update customer lists

PATCH {{baseUrl}}/ad_accounts/:ad_account_id/customer_lists/:customer_list_id

This endpoint is currently in beta and not available to all apps. Learn more.

Append or remove records to/from an existing customer list. (A customer list is one of the four types of Pinterest audiences.)

When you add records to an existing customer list, the system scans the additions for existing Pinterest accounts; those are the records that will be added to your “CUSTOMERLIST” audience. Your original list of records to add will be deleted when the matching process is complete.

For more information, see <a href=https://help.pinterest.com/en/business/article/audience-targeting target="blank>Audience targeting or the https://developers.pinterest.com/docs/features/ads-management/#Audiencestarget=_blank">Audiences section of the ads management guide.

Request Body

{"operation_type"=>"REMOVE", "records"=>"email2@pinterest.com,email6@pinterest.com,", "exceptions"=>{"code"=>2, "message"=>"Advertiser not found."}}

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":{}}