---
title: "Subscribe a webhook to events"
method: POST
path: "/api/v1/webhook_destinations"
tags: ["Webhook destinations"]
---

# Subscribe a webhook to events

`POST /api/v1/webhook_destinations`

## Request

- Base URL: `https://session-replay.com`
- URL: `https://session-replay.com/api/v1/webhook_destinations`
- Auth: HTTP bearer

Registers a URL of yours against a team you administer. Name the team with team_id, or leave it out and the destination is attached to your personal team. The response carries the signing key once, on create: every delivery is signed with it and there is no second chance to read it over the API.

## Headers

- `Authorization` string

## Response `201`

destination created

## Other responses

- `401`: unauthorized
- `404`: no such team for this caller
- `422`: the url cannot be reached

---

[API](https://skmtc.dev/session-replay/apis/session-replay-api.md) · [All operations](https://skmtc.dev/session-replay/apis/session-replay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/session-replay/apis/session-replay-api/revisions/120e5613bf95?raw)