Create Webhook

post

https://{subdomain}.fellow.app/api/v1/webhook

Create a new webhook endpoint.

Creates a webhook that will receive HTTP POST requests when subscribed events occur.
The webhook will be associated with the authenticated user.

Set scope to workspace to create an account-wide webhook instead, which receives every
matching event in the account and is delivered once per event rather than once per attendee.
Super Admin Access Required for that value: a key acting through X-On-Behalf-Of cannot
create one, because impersonation drops privileged access.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Request body for creating a webhook.

url

string

required

The URL endpoint that will receive webhook POST requests

enabled_events

array of strings

required

List of event types to subscribe to. Valid values: 'ai_note.shared_to_channel', 'ai_note.generated', 'action_item.assigned', 'action_item.completed'.

Enabled Events*

description

string

Optional description for this webhook endpoint

status

string

enum

Defaults to active

Webhook status. Valid values: 'active', 'inactive'

Allowed:

scope

string

enum

Defaults to user

Who the webhook belongs to. 'user' is the authenticated user, the default and the existing behaviour. 'workspace' is the whole account: it receives every matching event with no per-user filter, and each event is delivered once rather than once per attendee. Creating one requires a privileged API key.

Allowed:

Response

200OK