The Timer task lets you add a time delay to the
integration execution flow.
During an integration execution, when the control reaches the Timer task, execution is paused for the specified time limit, and all tasks after the Timer task are suspended. This task supports only automatic resumption of an integration. The integration execution automatically resumes after the expiry of the suspension time limit. For example, if you set the timer task to 180 seconds, the execution is paused for 3 minutes before resuming automatically.
Compare Approval task, Suspend task, and Timer task
All the three (Approval,
Suspend,
and Timer) tasks perform a similar
function of pausing and resuming an integration. However, there are subtle differences
among them. The following table describes the differences amongst the three tasks.
Approval task
Suspend task
Timer task
Doesn't support automatic resumption of an integration and requires
manual intervention to resume the integration.
Supports both manual and automatic resumption of an integration. If there is no
manual intervention to revoke the suspension, the integration will automatically
resume execution after the expiry of the suspension time limit.
Supports only automatic resumption of an integration. The integration execution
automatically resumes after the exipry of the suspension time limit.
Can't resume an integration via an API call. You must manually resolve the
suspension by using the Integrations UI.
Can resume an integration by using the Suspensions API for integrations.
Supports only automatic resumption of an integration.
Users receive notification when an integration pauses (suspended).
Users don't receive any notification when an integration pauses (suspended).
Users don't receive any notification when an integration pauses (suspended).
Supports a output variable (boolean), which allows you to perform conditional checks
before resuming an integration. However, the output variable can only have
the value as either true or false.
Supports a output variable (string), which allows you to perform conditional checks
before resuming an integration. You can set any value to the output variable.
Doesn't support any output variables.
Configure the Timer task
To configure the Timer task:
In the Google Cloud console, go to the Application Integration page.
The Integrations page appears listing all the integrations available in the Google Cloud project.
Select an existing integration or click Create integration to create a new one.
If you are creating a new integration:
Enter a name and description in the Create Integration pane.
Select a region for the integration.
Select a service account for the integration. You can change or update the service account details of an integration any time from the infoIntegration summary pane in the integration toolbar.
Click Create. The newly created integration opens in the integration editor.
In the integration editor navigation bar, click Tasks to view the list of available tasks and connectors.
Click and place the Timer task element in the integration editor.
Click the Timer task element on the designer to view the Timer task
configuration pane.
Configure the remaining fields using the Configuration properties for the task. For example, if you set Timeout after to 180 and Time unit to Seconds, the execution is paused for 3 minutes before resuming automatically.
Changes to the properties are saved automatically.
Configuration properties
The following table describes the configuration properties of the Timer task.
Property
Data type
Description
Timeout after
Integer
Time till which the integration execution must be paused. Integration
automatically resumes the execution of the next downstream task after the expiry of
the time limit.
Default value: 120 seconds (2 minutes).
Maximum time limit allowed: 44640 minutes (31 days).
Time unit
Seconds, Minutes, Hours, Days
Time unit for the Timeout after property.
Error handling strategy
An error handling strategy for a task specifies the action to take if the task fails due to a temporary error. For information about how to use an error handling strategy, and to know about the different types of error handling strategies, see Error handling strategies.
[[["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-09-03 UTC."],[[["\u003cp\u003eThe Timer task in Application Integration allows you to pause integration execution for a specified duration before automatically resuming.\u003c/p\u003e\n"],["\u003cp\u003eUnlike the Approval and Suspend tasks, the Timer task only supports automatic resumption and does not require or allow manual intervention.\u003c/p\u003e\n"],["\u003cp\u003eThe Timer task's pause duration is configurable via the "Timeout after" property and "Time unit," with a default of 120 seconds (2 minutes) and a maximum limit of 31 days.\u003c/p\u003e\n"],["\u003cp\u003eThe Timer task does not support output variables or user notifications when an integration pauses, differing from other similar tasks like the Approval and Suspend tasks.\u003c/p\u003e\n"],["\u003cp\u003eYou can configure a Timer task to pause an integration by setting a desired timeout and time unit in the task configuration pane, and this task is part of the broader set of supported connectors for Application Integration.\u003c/p\u003e\n"]]],[],null,["# Timer task\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nTimer task\n==========\n\nThe **Timer** task lets you add a time delay to the\nintegration execution flow.\n\nDuring an integration execution, when the control reaches the Timer task, execution is paused for the specified time limit, and all tasks after the Timer task are suspended. This task supports only automatic resumption of an integration. The integration execution automatically resumes after the expiry of the suspension time limit. For example, if you set the timer task to 180 seconds, the execution is paused for 3 minutes before resuming automatically.\n| **Note:** If you set the timer task to less than 60 seconds, the suspend state will be consistent as synchronous execution mode. Otherwise, the suspend state is consistent with the asynchronous execution mode.\n\nCompare Approval task, Suspend task, and Timer task\n---------------------------------------------------\n\nAll the three ([Approval](/application-integration/docs/approval-task),\n[Suspend](/application-integration/docs/run-suspend-task),\nand [Timer](/application-integration/docs/run-timer-task)) tasks perform a similar\nfunction of pausing and resuming an integration. However, there are subtle differences\namong them. The following table describes the differences amongst the three tasks.\n\nConfigure the Timer task\n------------------------\n\nTo configure the **Timer** task:\n\n1. In the Google Cloud console, go to the **Application Integration** page.\n\n [Go to Application Integration](https://console.cloud.google.com/integrations)\n2. In the navigation menu, click **Integrations** .\n\n\n The **Integrations** page appears listing all the integrations available in the Google Cloud project.\n3. Select an existing integration or click **Create integration** to create a new one.\n\n\n If you are creating a new integration:\n 1. Enter a name and description in the **Create Integration** pane.\n 2. Select a region for the integration. **Note:** The **Regions** dropdown only lists the regions provisioned in your Google Cloud project. To provision a new region, click **Enable Region** . See [Enable new region](/application-integration/docs/enable-new-region) for more information.\n 3. Select a service account for the integration. You can change or update the service account details of an integration any time from the info **Integration summary** pane in the integration toolbar. **Note:** The option to select a service account is displayed only if you have enabled integration governance for the selected region.\n 4. Click **Create** . The newly created integration opens in the *integration editor*.\n\n\n4. In the *integration editor* navigation bar, click **Tasks** to view the list of available tasks and connectors.\n5. Click and place the **Timer** task element in the integration editor.\n6. Click the **Timer** task element on the designer to view the **Timer** task configuration pane.\n7. Configure the remaining fields using the [Configuration properties](#params) for the task. For example, if you set **Timeout after** to `180` and **Time unit** to `Seconds`, the execution is paused for 3 minutes before resuming automatically.\n8. Changes to the properties are saved automatically.\n\nConfiguration properties\n------------------------\n\n\nThe following table describes the configuration properties of the Timer task.\n\nError handling strategy\n-----------------------\n\n\nAn error handling strategy for a task specifies the action to take if the task fails due to a [temporary error](/application-integration/docs/error-handling). For information about how to use an error handling strategy, and to know about the different types of error handling strategies, see [Error handling strategies](/application-integration/docs/error-handling-strategy).\n\nQuotas and limits\n-----------------\n\nFor information about quotas and limits, see [Quotas and limits](/application-integration/docs/quotas).\n\nWhat's next\n-----------\n\n- Learn about [all tasks and triggers](/application-integration/docs/all-triggers-tasks).\n- Learn how to [test and publish an integration](/application-integration/docs/test-publish-integrations).\n\n- Learn about [error handling](/application-integration/docs/error-handling-strategy).\n- Learn about [integration execution logs](/application-integration/docs/introduction-logs)."]]
