---
title: "Register a webhook."
method: POST
path: "/api/v4/f/{firm_id}/companies/{company_id}/webhooks"
tags: ["Webhooks"]
---

# Register a webhook.

`POST /api/v4/f/{firm_id}/companies/{company_id}/webhooks`

## Request

- Base URL: `https://live.getsilverfin.com`
- URL: `https://live.getsilverfin.com/api/v4/f/{firm_id}/companies/{company_id}/webhooks`
- Auth: OAuth 2
  - Authorization code: `https://live.getsilverfin.com/oauth/authorize`
  - Token URL: `https://live.getsilverfin.com/oauth/token` scopes: `webhooks`

<b>Required scope(s):</b> `webhooks`

## Path parameters

- `firm_id` integer, required
- `company_id` integer, required

## Headers

- `Accept` string

## Request body `multipart/form-data`

- object
  - `url` string, required: Valid https url
  - `events[]` string[], required: List of events that will trigger this webhook, you cannot update this list, so you should destroy the webhook and create a new one when you want to add or remove an event.

## Response `201`

Successful response

- object
  - `id` integer: webhook_id
  - `url` string
  - `events` string[]
  - `user_id` integer
  - `expired_at` string

---

[API](https://skmtc.dev/silverfin/apis/silverfin-api.md) - [All operations](https://skmtc.dev/silverfin/apis/silverfin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/silverfin/apis/silverfin-api/revisions/e418e4fc02e8?raw)