Webhooks

List webhook subscriptions

Retrieve all webhook subscriptions configured for a specific org.

Webhook subscriptions define which business events (like orders, menu updates, customer registrations) your application wants to receive notifications about. Each subscription specifies:

  • Event types: Which business events to monitor (e.g., order.created, menu.published)
  • Callback URL: Where to send webhook notifications (must be HTTPS)
  • Property scope: Either all properties or a specific restaurant location
  • Delivery preferences: Retry settings and alert emails

This endpoint returns a consolidated view where multiple event types for the same subscription are grouped together, making it easy to understand your webhook configuration at a glance.

Use cases:

  • Dashboard displaying current webhook integrations
  • Audit webhook configurations across your org
  • Troubleshoot webhook delivery issues
  • Monitor which events your integration is subscribed to
get/orgs/{orgId}/subscriptions

Request

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

Path parameters

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

Webhook subscriptions for org retrieved successfully

Example response

{
  "data": [
    {
      "propertyIds": [
        "p123",
        "p124"
      ]
    }
  ]
}

Changes

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