Method: projects.locations.integrations.execute

Executes integrations synchronously. The response is not returned until the requested execution is either fulfilled or experienced an error. Only one integration can be executed. Request format URL:$PROJECT/locations/$LOCATION/integrations/$INTEGRATION_NAME/executions?triggerId=xxx... Request payload: (the entire payload is optional unless input variables need to be set.) {"variable1": "hello world", "variable2": 1, "variable3": {"my_json_key": "my json string value" }

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The integration resource name.

Query parameters



Required. The API trigger id associated with the integration. An integration can have multiple triggerId. This field is required to disambiguate which trigger should be invoked.



Optional. This is used to de-dup incoming request: if the duplicate request was detected, the response from the previous execution is returned.

Request body

The request body contains an instance of Struct.

Response body

If successful, the response is a generic HTTP response whose format is defined by the method.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • integrations.integrations.invoke

For more information, see the IAM documentation.