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. The time that the integration should be executed. If the time is less or equal to the current time, the integration is executed immediately.
Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-22 UTC."],[[["\u003cp\u003eThis API endpoint schedules an integration for execution using a POST request to a specific URL with the integration's resource name.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a trigger ID to specify which trigger within the integration should be invoked and accepts an optional schedule time for delayed execution.\u003c/p\u003e\n"],["\u003cp\u003eThe request accepts path parameters like the integration resource name (\u003ccode\u003eparent\u003c/code\u003e), and query parameters such as \u003ccode\u003etriggerId\u003c/code\u003e, \u003ccode\u003escheduleTime\u003c/code\u003e, and \u003ccode\u003erequestId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body uses a \u003ca href=\"https://protobuf.dev/reference/protobuf/google.protobuf/#struct\"\u003eStruct\u003c/a\u003e, and successful requests return a generic HTTP response.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e and the IAM permission \u003ccode\u003eintegrations.integrations.invoke\u003c/code\u003e on the parent resource.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.integrations.schedule\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\nSchedules an integration for execution.\n\n### HTTP request\n\n`POST https://integrations.googleapis.com/v2/{parent=projects/*/locations/*/integrations/*}:schedule`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [Struct](https://protobuf.dev/reference/protobuf/google.protobuf/#struct).\n\n### Response body\n\nIf successful, the response is a generic HTTP response whose format is defined by the method.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `integrations.integrations.invoke`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]