Multi-party approvals in the Google Ads API

As part of improving security for Google Ads accounts, the Google Ads API will start requiring multi-party approvals when performing sensitive API actions. This is part of a broader change in Google Ads that requires multi-party approvals to perform sensitive actions in your Google Ads account. These important security updates will start rolling out starting on July 27, 2026 , and will be enabled for all users over the next few weeks. What is changing? When this change goes live, the following API calls will change their behavior. Inviting a user If you use the CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation method to invite a new user to manage a Google Ads account, the Google Ads API now evaluates whether multi-party approval may be necessary. In cases where our servers determine that a review is required, the system will pause the standard workflow and will not immediately generate a CustomerUserAccessInvitation or dispatch the invitation email. A MultiPartyAuthReview resource is initiated instead, with its resource name provided in the response. Once the pending review receives approval from a second account administrator, the CustomerUserAccessInvitation will be created and the invited user will receive their email. No new invites can be created for the user until the pending review is resolved. Updating or terminating a user’s access If you use the CustomerUserAccessService.MutateCustomerUserAccess method to adjust a user's permissions using the update operation or revoke access using the remove operation , the Google Ads API now evaluates whether multi-party approval may be necessary. In cases where our servers determine that a review is required, the API generates a MultiPartyAuthReview resource in a pending state and returns its resource name . Your requested modifications will remain pending and will only take effect once the multi-party review is successfully approved by a second account administrator. The CustomerUserAccess under review cannot be mutated until the pending review is resolved. How do I approve a multi-party approval request? You can fetch a pending MultiPartyAuthReview by using the GoogleAdsService.Search or GoogleAdsService.SearchStream methods, using the following GAQL query. SELECT multi_party_auth_review.resource_name, multi_party_auth_review.multi_party_auth_review_id, multi_party_auth_review.creation_date_time, multi_party_auth_review.request_user_email, multi_party_auth_review.operation_type, multi_party_auth_review.justification, multi_party_auth_review.target_resource, multi_party_auth_review.customer_user_access_review.old_customer_user_access, multi_party_auth_review.customer_user_access_review.new_customer_user_access, multi_party_auth_review.customer_user_access_invitation_review.new_customer_user_access_invitation FROM multi_party_auth_review WHERE multi_party_auth_review.review_status = 'PENDING' A pending MultiPartyAuthReview request can be approved or rejected using a MultiPartyAuthReviewService.ResolveMultiPartyAuthReview API request. The review needs to be done by a second administrator who did not create the original request. This can either be a human or a service account with administrator privileges. The pending review can be revoked by the original requestor. What do I need to do? If your application uses these methods, make sure to update it to handle the multi-party approval workflows before July 27, 2026 . We have added support for multi-party approvals to all the major versions of the API (v24.2, v23.3, v22.2 and v21.2). If you are using an official client library, make sure to download their latest version . You can refer to the following guides to learn more about these changes, which cover details on Various states of a multi-party approval request How to retrieve and review multi-party approval requests How to handle multi-party approval requests when inviting users How to handle multi-party approval requests when updating user roles or removing user access For any questions or further discussion regarding this update, please connect with us on the "Google Advertising and Measurement Community" Discord server . For technical support issues, reach out to - Anash P. Oommen , Google Ads API Team