eatsy

Webhook Management

Use the eatsy dashboard to create, rotate, and delete webhook configurations for your business.

Create

You can create a webhook from the eatsy dashboard in Desarrollador > Webhooks.

Webhook management dashboard in eatsy

To create a webhook:

  1. Click Crear webhook.
  2. Enter the HTTPS URL where eatsy should send events.
  3. Keep the webhook enabled if you want eatsy to start sending events immediately.
  4. Confirm the available event. Currently, eatsy supports configuring order.paid.
  5. Choose whether the webhook should receive events from every location or only specific locations.
  6. Click Crear.

Webhook creation form

When the webhook is created successfully, eatsy generates a unique secret for that webhook. This secret is shown only once.

Dialog showing the generated webhook secret

Store this value in your system. Your endpoint must compare it against the X-eatsy-Webhook-Secret header on every request.

After you close the dialog, the secret cannot be viewed again. If you lose it, rotate the webhook secret.

Rotate

Rotating a webhook generates a new secret for that webhook. The previous secret stops working immediately.

Use rotation if the secret was accidentally exposed, your internal policy requires credential changes, or your team lost access to the original secret.

Webhook secret rotation confirmation

To rotate a secret:

  1. Find the webhook in the webhook table.
  2. Click Rotar secreto.
  3. Confirm the action.
  4. Store the new secret that eatsy shows only once.
  5. Update your server to validate the new X-eatsy-Webhook-Secret value.

Until your system uses the new secret, it may reject valid webhook requests from eatsy.

Delete

Deleting a webhook permanently removes that configuration. eatsy will stop sending events to that endpoint.

Webhook deletion confirmation

To delete a webhook:

  1. Find the webhook in the webhook table.
  2. Click Eliminar.
  3. Confirm the action.

This action cannot be undone. If you want to receive events at that endpoint again, create a new webhook.