---
title: "Create a webhook"
method: POST
path: "/v1/webhooks"
---

# Create a webhook

`POST /v1/webhooks`

## Request

- Base URL: `https://app.snap-render.com`
- URL: `https://app.snap-render.com/v1/webhooks`
- Auth: API key in header `X-API-Key`

Register a webhook URL to receive event notifications. Max 5 webhooks per account. Payloads are signed with HMAC-SHA256 using the returned secret.

## Request body

- object
  - `url` string, uri, required: HTTPS endpoint URL for webhook delivery
  - `events` string[], required: Events to subscribe to

## Response `201`

Webhook created

- WebhookResponse
  - `id` string, uuid
  - `url` string, uri
  - `events` string[]
  - `secret` string: HMAC-SHA256 signing secret (whsec_ prefix). Store securely.
  - `isActive` boolean
  - `createdAt` string, date-time

## Other responses

- `400`: Invalid request or max webhooks reached
- `401`: Unauthorized

---

[API](https://skmtc.dev/snap-render/apis/snaprender-screenshot-api.md) · [All operations](https://skmtc.dev/snap-render/apis/snaprender-screenshot-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snap-render/apis/snaprender-screenshot-api/revisions/420ff88deeb2?raw)