Documentation

​
​

Development

User Acquisition

Monetization

Industry

Triggers

Triggers Admin API

Scheduler Admin API

Open Unity Dashboard

Triggers

LiveOps
​
​
Get started
  • Overview
  • Get started
  • Set up triggers example workflow
  • Authentication
Set up events
  • Understand and manage events
  • Schedule events
Define triggers
  • Define triggers
Configure actions
  • Use Cloud Code
  • Use webhooks
Manage and monitor
  • Use the dead letter queue (DLQ)
  • Limits
  • Failure handling
Examples and reference
  • Use case samples
  1. Triggers

Failure handling

Learn how Triggers handles errors and retries for Cloud Code and webhook actions, and when events enter the dead letter queue.
Read time 2 minutes
Last updated 5 months ago

Both Cloud Code and webhook actions can produce failed events. These events are retried and, if all retry attempts are exhausted, might be moved to the dead letter queue. Refer to Dead letter queue for event statuses and management options.

Cloud Code actions

If the invoked Cloud Code script or module returns an error response, the action is not retried.
If an internal problem occurs during execution (for example a timeout or service failure), the Triggers service retries the execution. After retries are exhausted, the event can be added to the dead letter queue.
To monitor and debug the execution of your triggers, use Logging.

Webhook actions

When a trigger uses a webhook action, the Triggers service sends an HTTP request to your configured URL. The service makes up to 3 application-level retries using exponential backoff, starting at 1 second and capping at 30 seconds per interval. If all retries fail, the event is added to the dead letter queue.
The following table describes which responses are retried.

Response

Retried

Notes

5xx server errorsYesFor example 500, 502, 503, 504.
429 Too Many RequestsYesThe service honors the
Retry-After
response header on 429 and 503 responses when it contains an integer number of seconds.
Timeouts and network errorsYes
4xx client errors (except 429)NoFor example 400, 401, 403, 404. Not added to the dead letter queue. Fix the webhook configuration or endpoint and trigger a new event.

Additional resources

  • Dead letter queue
  • Webhooks
  • Limits
  • Manage the dead letter queue in the Unity Dashboard
  • Manage the dead letter queue with the CLI
  • Manage the dead letter queue with the REST API

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page
    • Cloud Code actions

    • Webhook actions

    • Additional resources


Report a problem with this page