# Delivery and Retries

## Request format

- **Method:** HTTP `POST`
- **Content-Type:** `application/json`
- **User-Agent:** `IDEASOFT-WEBHOOK`
- **Signature header:** `X-Ideashop-Hmac-Sha256` (see [Security](/webhooks/security))

## Retry rule

Depending on the response from your endpoint:

| Response | Behaviour |
|---|---|
| `2xx` | Considered successful |
| `5xx` | The message is re-queued and retried |
| Other (`3xx`, `4xx`, timeout) | Not retried; the delivery is dropped |

- Retries continue up to a configured requeue limit (default **3** attempts).
- When the limit is exceeded the delivery is abandoned and logged; your webhook subscription is **not** deleted or deactivated — subsequent events keep being sent.
- Each request uses a configured curl timeout (default **3 seconds**).

:::warning{title="Behaviour note"}
Retries happen only for `5xx` responses. Deliveries rejected with `4xx` or hitting the timeout are not retried; your endpoint must respond quickly with `2xx`.
:::

:::tip{title="Respond fast"}
Your webhook handler should accept the message and return `2xx` immediately; do the heavy work asynchronously.
:::
