Basic Information

appmixer.googleAds.core.AddUserToUserList

1.0.0

Public

Adds or removes a single user from a Customer Match user list via UserDataService.UploadUserData. Best for sporadic, real-time updates (e.g. CRM webhook). Limit: 1 user per call. Note: updates do not appear in the Google Ads UI upload history.

Input Ports

in

FieldTypeDescription
Customer ID text -
Login Customer ID text The Google Ads Manager Account (MCC) ID. Required when accessing accounts managed through an MCC hierarchy. Format: 10-digit number, e.g. 1234567890. See https://developers.google.com/google-ads/api/docs/concepts/call-structure#login-customer-id
User List ID text Numeric ID of the Customer Match user list. Use either User List ID or User List Resource Name.
User List Resource Name text Full resource name, e.g. customers/123/userLists/456. Use either this or User List ID.
Email text Email address of the user. Provide either email OR phone OR (firstName + lastName + countryCode) OR mobileId OR thirdPartyUserId.
Phone Number text Phone number in E.164 format (e.g., +1234567890). Provide either email OR phone OR (firstName + lastName + countryCode) OR mobileId OR thirdPartyUserId.
First Name text First name. Use with lastName and countryCode for address-based matching.
Last Name text Last name. Use with firstName and countryCode for address-based matching.
Country Code text 2-letter ISO-3166-1 alpha-2 country code (e.g., US, CA, GB). Use with firstName and lastName for address-based matching.
Postal Code text Postal/ZIP code. Optional with address-based matching.
Mobile Device ID text Mobile device ID (IDFA for iOS or Google Advertising ID for Android). Provide either email OR phone OR (firstName + lastName + countryCode) OR mobileId OR thirdPartyUserId.
Third Party User ID text Advertiser-assigned user ID. Provide either email OR phone OR (firstName + lastName + countryCode) OR mobileId OR thirdPartyUserId.
Operation select Whether to add (create) or remove the user from the list.
Ad User Data Consent select Consent status for use of user data for ads. Required for 'Add' operations.
Ad Personalization Consent select Consent status for ad personalization. Required for 'Add' operations.

Output Ports

out

FieldTypeDescription
Received Operations Count integer -
Upload Date Time string -
User List Resource Name string -
Operation string -

Full Metadata