Update customer list

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

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 “CUSTOMER_LIST” audience. Your original list of records to add will be deleted when the matching process is complete.

For more information, see Audience targeting or the Audiences section of the ads management guide.

Request Body

{"operation_type"=>"REMOVE", "records"=>"<string>", "exceptions"=>{"code"=>"<integer>", "message"=>"<string>"}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

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