Webhooks

Delete webhook subscription

Permanently delete a webhook subscription and stop receiving event notifications for the specified subscription.

What happens when you delete a subscription:

  • Immediate effect: No new webhooks will be sent to the callback URL
  • Event history: Past webhook deliveries remain in logs for audit purposes
  • Multi-event cleanup: All event types associated with this subscription are removed
  • No recovery: Deleted subscriptions cannot be restored (you'll need to create a new one)

Before deleting:

  • Ensure your application no longer needs these webhook notifications
  • Consider disabling the subscription temporarily instead if you're unsure
  • Review which event types will be affected by this deletion

Use cases:

  • Removing outdated or unused webhook integrations
  • Cleaning up test subscriptions
  • Migrating to new webhook endpoints (delete old, create new)
  • Decommissioning applications that no longer need event notifications
delete/orgs/{orgId}/subscriptions/{subId}

Request

  • Base URL: https://api.flipdish.co/webhooks
  • URL: https://api.flipdish.co/webhooks/orgs/{orgId}/subscriptions/{subId}
  • Auth: API key in header Authorization

Path parameters

subIdstring required
Example:sub_c7129f82-c87d-470c-a8c8-cae6b07762e2

Unique webhook subscription identifier that tracks a specific webhook configuration within an org. Each subscription defines which events to listen for, where to send webhooks (callback URL), and delivery preferences. Subscriptions can monitor multiple event types and are scoped to either all properties within an org or a specific property. Format: "sub_" followed by a UUID (e.g., sub_c7129f82-c87d-470c-a8c8-cae6b07762e2).

orgIdstring required
Example:org123

Unique organization identifier representing a restaurant chain, franchise group, or independent restaurant business in the Flipdish platform. Organizations are the top-level tenant entity that groups brands, properties, and sales channels together. All webhook subscriptions are scoped to a specific organization to ensure proper data isolation and access control. Format: "org" followed by numbers (e.g., org123, org456).

Response

No Content - subscription deleted successfully

Changes

No recorded changes to this operation across all 1 revision of this API.