Upload a Customer Match audience via Google Ads Data Manager API

Steps

1. Confirm your developer token is allowlisted for Customer Match; as of April 2026, OfflineUserDataJobService uploads are disabled for non-allowlisted tokens (CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE).
2. Use the Google Ads Data Manager API (the current primary path for Customer Match uploads) to create or update a user list; authenticate with the same OAuth 2.0 flow as other Google Ads API calls.
3. Hash all PII fields (email, phone, first name, last name) with SHA-256 in lowercase normalized form before including them in the upload payload.
4. Submit the user data records to the Data Manager API endpoint, specifying the target customer ID and the user list resource name.
5. Poll the operation status until the job reaches a terminal state (SUCCEEDED or FAILED) and review any partial failure details.
6. Verify audience size in the Google Ads UI under Audience Manager; note that sizes below the minimum threshold (typically 1,000 matched users) will not serve.