---
title: "Create a webhook endpoint"
method: POST
path: "/webhooks"
tags: ["Webhooks"]
---

# Create a webhook endpoint

`POST /webhooks`

## Request

- Base URL: `https://restapi.fax.plus/v3`
- URL: `https://restapi.fax.plus/v3/webhooks`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://accounts.fax.plus/login?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=http://localhost&scope=all`
    - Token URL: `https://accounts.fax.plus/token` scopes: `all`
  - HTTP bearer

Create a webhook endpoint. `url` and `filter_types` (min 1) are required. Returns 201 with an empty body. Requires webhooks to be enabled in Integrations. (Permitted scopes: **fax:all:edit**, **fax:webhook:edit**)

## Request body

- WebhookEndpointCreate: Create a webhook endpoint. `url` and `filter_types` are required.
  - `url` string, required
  - `filter_types` WebhookFilterType[], required
  - `channels` string[], nullable
  - `description` string
  - `disabled` boolean
  - `headers` object
  - `throttle_rate` integer

## Response `201`

Endpoint was successfully created. Body is an empty object; list endpoints to read the `ep_…` id.

- object

## Other responses

- `400`: Error object in case there's a problem with given data
- `403`: Error object in case there's a problem with given data
- `404`: Requested resource was not found
- `500`: Error object in case there's a server error

## Changes

- **2026-11-03** `95a35a892239`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fax/apis/fax-plus-rest-api/changes/webhooks/post.md)

---

[API](https://skmtc.dev/fax/apis/fax-plus-rest-api.md) - [All operations](https://skmtc.dev/fax/apis/fax-plus-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fax/apis/fax-plus-rest-api/revisions/95a35a892239?raw)