> For the complete documentation index, see [llms.txt](https://glyue.docs.sandboxbanking.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://glyue.docs.sandboxbanking.com/how-to-guides/how-to-configure-integration-retry.md).

# How to Configure Integration Retry

Integration Retry enables automatic retry logic for failed integrations. When an integration run fails, the system can automatically retry the execution based on a configurable schedule, which reduces the need for manual intervention in cases of transient failures.

## Prerequisites

* Admin or staff permissions on the Integration Gateway instance.
* An existing integration with an Integration Config record.

## Configure Retry Settings

1. Navigate to **Build**.
2. Right-click the integration you want to configure and select **Configure**.
3. In the Configure Integration dialog, expand the **Retry Settings** panel.
4. Select a **Retry Mode**:
   * **None** — No retries (default).
   * **Fixed Interval** — Retries at a constant delay between each attempt.
   * **Exponential Backoff** — Retries with increasing delays. Each subsequent retry waits longer than the previous one.
5. Set the **Initial Retry Delay (seconds)** — the base wait time before the first retry. For Fixed Interval, this is the delay between every attempt. For Exponential Backoff, this value doubles with each subsequent attempt.
6. Set the **Retry Delay Jitter (seconds)** — a random value between 0 and this number is added to each delay. Jitter prevents multiple failing integrations from retrying at the same time.
7. Set the **Retry Count** — the maximum number of retry attempts before the integration is marked as failed.
8. Click **Save**.

## Field Reference

| Field                         | Type    | Default | Range                                     |
| ----------------------------- | ------- | ------- | ----------------------------------------- |
| Retry Mode                    | Select  | None    | None, Fixed Interval, Exponential Backoff |
| Initial Retry Delay (seconds) | Integer | 5       | 1–600                                     |
| Retry Delay Jitter (seconds)  | Integer | 2       | 0–120                                     |
| Retry Count                   | Integer | 3       | 1–10                                      |

## How nCino Calculates Retry Delay

**Fixed Interval:**

```
delay = retry_delay_seconds + random(0, retry_delay_jitter)
```

**Exponential Backoff:**

```
delay = (retry_delay_seconds × 2^attempt) + random(0, retry_delay_jitter)
```

Where `attempt` starts at 0 for the first retry.

**Example:** With a 5-second base delay, 2-second jitter, and Exponential Backoff:

| Attempt   | Base Delay   | Possible Total (with jitter) |
| --------- | ------------ | ---------------------------- |
| 1st retry | 5s (5 × 2⁰)  | 5–7s                         |
| 2nd retry | 10s (5 × 2¹) | 10–12s                       |
| 3rd retry | 20s (5 × 2²) | 20–22s                       |

## Viewing Retry History

Each retry attempt creates its own entry in the Run History. Retry runs are labeled with `retry_for_run_id:<original_id>`, which links them back to the original failed run.

The `retry_attempt` variable is available in integration hooks, which allows hook logic to behave differently based on the current attempt number.

## Limits

The maximum effective retry delay cannot exceed 5 minutes (300 seconds). For Exponential Backoff mode, the system validates that the longest possible delay (on the final retry attempt plus jitter) stays within this limit.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://glyue.docs.sandboxbanking.com/how-to-guides/how-to-configure-integration-retry.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
