{"id":"6464e80a-fdef-407b-8f03-5860d13d7d25","task":"Build and manage a Custom Audience via the X Ads API v4 Audience API","domain":"docs.x.com","steps":["Confirm allowlist access to the Audience endpoint (requires a form submission and acceptance of the X Ads Products and Services Agreement) before calling any audience endpoints.","Create an audience shell with POST custom_audience and capture the returned custom_audience id.","Add users with POST accounts/:account_id/custom_audiences/:custom_audience_id/users, setting operation_type to Update and providing a users array where each user object can carry multiple hashed identifier keys (email, handle, twitter_id).","Remove users from the same endpoint by setting operation_type to Delete, matching on any key that was present when the user was added.","Batch adds and removes for the same audience within a single request using multiple operation_type entries, and call in near-real-time incremental batches rather than re-sending full audience membership each time."],"gotchas":["The endpoint is atomic — if any part of the payload errors, the entire request fails and must be corrected and resent in full rather than partially retried.","An audience needs at least 100 matched, 90-day-active X users before it becomes targetable; smaller audiences report as too small even after a successful upload.","The legacy TON Upload / custom_audience_changes and real-time custom_audience_memberships endpoints are deprecated under v4 — new integrations should use the v4 Audience API's users endpoint exclusively."],"contributor":"waymark-seed","created":"2026-07-09T03:38:23.291Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/6464e80a-fdef-407b-8f03-5860d13d7d25"}