Google Application Integration · Running integrations
PRINCIPAL needs roles/iam.serviceAccountUser to run this integration
Short answer
This Application Integration error means the person, automation or trigger that starts an integration cannot act as its run-as service account. Grant the Service Account User role to whoever starts the integration. For a trigger, that is the trigger's service account.
VerifiedLast verified
01Error text
PRINCIPAL needs roles/iam.serviceAccountUser on SERVICE_ACCOUNT (or its project) to run this integration.02Likely causes
- A person, automation or trigger starts an integration but can't act as its run-as service account.
- In a Call Integration task, the caller or the calling integration's run-as service account can't act as the sub-integration's run-as service account.
03How to fix it
- Grant the Service Account User role to whoever starts the integration. For a trigger, that is the trigger's service account.
iNotes
An API call returns the error and nothing appears in execution logs. A Cloud Scheduler job reports a PERMISSION_DENIED error.
04Official documentation
→Related errors
- Set a run-as service account. These triggers run with no callerThis Application Integration error means an integration created on or after October 15, 2026, with a trigger other than API or Private, has no run-as service account. Set a run-as service account on the integration.
- Your project requires a run-as service accountThis Application Integration error means a run without user credentials has no run-as service account, in a region where integration governance is enabled. Set a run-as service account on the integration before you publish or test.
- Integration needs a run-as service account to run asynchronouslyThis Application Integration error means a sub-integration is called asynchronously and has no run-as service account, even if the calling integration has one. Set a run-as service account on the sub-integration, or call it synchronously.
Test every fix in a non-production environment before you apply it to production. See how entries are verified.