# Get webhook settings

`GET /api/webhook/outbound/config`  (operationId: `getWebhookConfig`, group: Webhooks)

The saved endpoint and subscribed events, plus the catalogue of every event with whether this workspace can subscribe to it.

Part of the full API, which is included in the Scale plan. Any one of these scopes is enough: `settings`, `settings:read`.

**Response 200**: OK (schema `WebhookConfig`)

| Field | Type | Description |
| --- | --- | --- |
| `configured` | boolean |  |
| `endpoint_url` | string |  |
| `events` | array of string |  |
| `enabled` | boolean |  |
| `updated_at` | string (date-time), nullable |  |
| `updated_by_name` | string, nullable |  |
| `valid_events` | array of string |  |
| `api_tier` | string | What the plan includes: none (Starter), core (Growth), full (Scale). One of: `none`, `core`, `full`. |
| `webhooks_available` | boolean | False on Starter, which has no webhooks. |
| `event_catalog` | array of object |  |
| `event_catalog[][].event` | string |  |
| `event_catalog[][].group` | string |  |
| `event_catalog[][].plan` | string | One of: `any`, `scale`. |
| `event_catalog[][].description` | string |  |
| `event_catalog[][].available` | boolean | False when the event needs a plan this workspace is not on: Starter has none, Growth has the events marked any, Scale has all. |
| `credit_alert_levels` | array of integer |  |

Example:

```json
{
  "configured": true,
  "endpoint_url": "https://example.com/hooks/inboxwa",
  "events": [
    "message_received",
    "message_status"
  ],
  "enabled": true,
  "updated_at": "2026-09-25T10:00:00.000Z",
  "updated_by_name": "admin@example.com",
  "valid_events": [
    "message_received",
    "message_status"
  ],
  "api_tier": "full",
  "webhooks_available": true,
  "event_catalog": [
    {
      "event": "message_status",
      "group": "Messages",
      "plan": "scale",
      "description": "An outbound message is delivered, read or fails, with the WhatsApp timestamp.",
      "available": true
    }
  ],
  "credit_alert_levels": [
    80,
    100
  ]
}
```

Part of the InboxWA API reference: https://inboxwa.online/docs/api . Full reference as one document: https://inboxwa.online/docs/api.md . OpenAPI: https://inboxwa.online/openapi.json