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:

https://integrations.googleapis.com/v2/projects/$PROJECT/locations/$LOCATION/integrations/$INTEGRATION_NAME:execute


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

POST https://integrations.googleapis.com/v2/{parent=projects/*/locations/*/integrations/*}:execute

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The integration resource name.

Query parameters

Parameters
triggerId

string

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.

requestId

string

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:

  • https://www.googleapis.com/auth/cloud-platform

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.