Select the X Ads account that owns the Do Not Reach list.
do_not_reach_list_id
string or SelectItem
Yes
-
Do Not Reach list ID. Find it with x_ads_list_do_not_reach_lists.
identifier_type
enum (email, phone_number)
No
email
Identifier type for this batch (one type per run): email (default) or phone_number.
users
string or array of string
Yes
-
The identifiers to suppress, as a list or comma/newline separated text. Plain values are normalized per X’s rules and SHA256-hashed automatically; already-hashed 64-character values pass through.
remove
boolean
No
False
Remove these identifiers from the list instead of adding them.
expires_at
string
No
-
When the suppression expires: ISO 8601 or a Unix timestamp, under 13 months out. X keeps the entries until it decides otherwise when omitted.