Skip to main content

API reference

All operations: Organization

Every Organization operation: webhook endpoints, events and reads of the organization.

Generated from the API's OpenAPI spec, so it always matches what the API serves.

Webhook endpoints, their deliveries and events, and reads of the organization behind the key: its members, integrations and API keys. Guide: Webhook subscriptions.

Generated from the API's OpenAPI spec: 15 operations. Request and response bodies for each are in the API reference. The MCP tool column names the tool in Finn's MCP server that makes the same call.

Webhooks

EndpointWhat it doesScopeMCP toolNotes
GET /webhook_endpointsList webhook endpointsadmin:webhookscursor pages
POST /webhook_endpointsCreate a webhook endpointadmin:webhooksIdempotency-Key
GET /webhook_endpoints/{id}Get a webhook endpointadmin:webhooks
PATCH /webhook_endpoints/{id}Update, enable or disable a webhook endpointadmin:webhooks
DELETE /webhook_endpoints/{id}Delete a webhook endpointadmin:webhooks
GET /webhook_endpoints/{id}/deliveriesList an endpoint's deliveriesadmin:webhookscursor pages
GET /eventsList webhook event typesadmin:webhooks
POST /webhook_endpoints/{id}/testSend a test eventadmin:webhooks
POST /webhook_endpoints/{id}/deliveries/{delivery_id}/redeliverRedeliver an eventadmin:webhooks
POST /webhook_endpoints/{id}/rotate_secretRotate the signing secretadmin:webhooks

Admin

EndpointWhat it doesScopeMCP toolNotes
GET /organizationGet the organizationadmin:readget_organization
GET /organization/membersList membersadmin:readlist_org_memberscursor pages
GET /organization/integrationsList integrationsadmin:readlist_org_integrationscursor pages
GET /organization/api_keysList API keysadmin:readcursor pages
GET /usageGet API usage by key and dayadmin:read