Skip to content
Ideasoft
Webhooks

Delivery and Retries

Request format

  • Method: HTTP POST
  • Content-Type: application/json
  • User-Agent: IDEASOFT-WEBHOOK
  • Signature header: X-Ideashop-Hmac-Sha256 (see Security)

Retry rule

Depending on the response from your endpoint:

ResponseBehaviour
2xxConsidered successful
5xxThe 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).

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.

Respond fast

Your webhook handler should accept the message and return 2xx immediately; do the heavy work asynchronously.

Last modified on