---
search:
  tags:
    - webhooks
    - POST
seo:
  description: >-
    Create a webhook subscription (scope webhooks:admin). Reference for the POST
    /api/v1/webhooks endpoint in the Basenet Public API.
sidebar:
  label: Create a webhook subscription (scope webhooks:admin)
  badge: POST
title: Create a webhook subscription (scope webhooks:admin)
type: openapi-operation
---
Endpoint: `POST /api/v1/webhooks`

Authentication: `bearerAuth` (Scoped API token (bnx\_…). Required scopes are noted per operation.)

Request body (`application/json`):
- `eventType` (one of `"matter.created"`, `"relation.created"`, `"hour.created"`, `"task.created"`, `"invoice.sent"`, required)
- `url` (string, required)
- `secret` (string, required)
- `active` (boolean, optional)

Responses:
- `201`: Created resource
- `400`: Invalid request
- `401`: Unauthenticated
- `403`: Forbidden (missing scope or permission)
- `429`: Rate limited

Response 201 body (`application/json`):
- `id` (string, required)
- `eventType` (one of `"matter.created"`, `"relation.created"`, `"hour.created"`, `"task.created"`, `"invoice.sent"`, required)
- `url` (string, required)
- `active` (boolean, required)
- `createdAt` (string, required)