---
title: "Create Webhook"
method: POST
path: "/v1/webhooks"
tags: ["webhooks"]
---

# Create Webhook

`POST /v1/webhooks`

Create a new webhook, which will be notified of events that occur in the system

## Request body

- StreemApiCreateWebhookRequest
  - `company_sid` string
  - `label` string
  - `url` string
  - `method` string
  - `timeout_ms` integer
  - `max_attempts` integer
  - `headers` StreemApiWebhookHeader[]
    - `name` string
    - `value` string
    - `include_in_request_signature` boolean

## Response `200`

Webhook created successfully

- StreemApiCreateWebhookResponse
  - `webhook` StreemApiWebhook
    - `sid` string
    - `company_sid` string
    - `label` string
    - `url` string
    - `method` string
    - `timeout_ms` integer
    - `max_attempts` integer
    - `headers` StreemApiWebhookHeader[]
      - `name` string
      - `value` string
      - `include_in_request_signature` boolean
  - `signing_key` StreemApiWebhookSigningKey
    - `sid` string
    - `webhook_sid` string
    - `shared_secret` string
    - `expires_at` string, date-time
    - `label` string

## Other responses

- `400` — Invalid request body (check response errors)
- `403` — You do not have permission to create webhooks

---

[API](https://skmtc.net/streem/apis/streem-api.md) · [All operations](https://skmtc.net/streem/apis/streem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streem/streem-api/revisions/04250faebd19/schema)