---
title: "Register webhook endpoint"
method: POST
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# Register webhook endpoint

`POST /v1/webhooks`

## Request

- Base URL: `https://api.offshoreproz.com`
- URL: `https://api.offshoreproz.com/v1/webhooks`
- Auth: HTTP bearer

Register a URL to receive formation events. Returns a `webhook_secret` (whsec_...) for signature verification. Events: formation.created, formation.status_changed, formation.complete, formation.pilot_review_pending.

## Request body

- object
  - `url` string, uri, required
  - `description` string
  - `events` string[]: Omit for all events

## Response `201`

Webhook created

- object
  - `data` object
    - `id` string
    - `url` string
    - `webhook_secret` string: whsec_... — used to verify signatures. Shown ONCE.
  - `request_id` string

## Other responses

- `401`: Unauthorized — invalid or missing API key

---

[API](https://skmtc.dev/offshoreproz/apis/offshoreproz-agent-api.md) · [All operations](https://skmtc.dev/offshoreproz/apis/offshoreproz-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/offshoreproz/apis/offshoreproz-agent-api/revisions/13026c827538?raw)