Update Catalogue Overrides Webhook

post

https://api.developers.deliveroo.com/webhooks-update-overrides

This webhook notifies you of the result of an overrides upload, once per upload. Correlate it to your submission using the upload_id returned by the upload endpoint. The status field reports whether processing succeeded or failed, and error_messages lists any problems.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

event

string

enum

Name of the event. Used to differentiate between UpdateCatalogueOverridesWebhookResponse and other events.

Allowed:

created_at

date-time

The time when the upload request was created.

brand_id

string

The external brand ID.

catalogue_id

string

The ID of the catalogue.

status

string

enum

Allowed:

upload_id

string

Identifier for this overrides upload — the same upload_id returned by the upload endpoint.

updated_at

date-time

The time when the upload request was last updated.

error_messages

array of strings

Present when status is external_error or internal_error. For a validation failure this is a single grouped summary — not one message per item: a header ("N of M items failed validation. K distinct error(s):") followed by one line per distinct error, each with the affected-item count and up to 10 example item ids. It is size-capped, so a run with many failures is truncated. Treat it as a human-readable diagnostic, not a machine-parseable per-item list.

error_messages

warnings

array of objects

Warnings that occurred during processing. These do not affect the success of the operation.

warnings

Headers

x-deliveroo-sequence-guid

string

required

Deliveroo Sequential globally unique identifier (GUID). Please implement it as case-insensitive.

x-deliveroo-hmac-sha256

string

required

On registration, we'll provide you with a webhook secret. We'll use the webhook secret and a sequential globally unique identifier (GUID) to generate a hash of the order payload. When you receive a POST request, you will be able to compute a hash and verify that it's a genuine, authorized request sent from Deliveroo. Please implement it as case-insensitive.

Responses

200

Your server returns this code if it accepts the callback.

4XX

Your server can return 4XX codes to signal its issues with the request.

5XX

Your server can return 5XX codes to signal its internal issues.

Language

Credentials

OAuth2

URL

Loading…