---
title: "Create a webhook endpoint"
method: POST
path: "/webhook/endpoints"
tags: ["Webhooks"]
---

# Create a webhook endpoint

`POST /webhook/endpoints`

After creating a webhook endpoint, we will POST to the webhook URL whenever certain events happen in our system.

## Headers

- `Arcadia-Version` string, required

## Request body

- CreateWebhookBodyParams
  - `url` string, required — The URL that webhook events should be POSTed to.
  - `arc_version` string — The version of the Arcadia API this endpoint is designed to understand. The JSON body corresponding to a webhook event type may change across versions. Arcadia will continue to send events to this endpoint using the event schemas as they existed in the selected version, insulating you from breaking changes.

## Response `200`

Success

- WebhookEndpoint
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `id` string, uuid, required
  - `signing_key` string, required
  - `url` string, required
  - `sandboxed` boolean, required
  - `enabled` boolean, required
  - `arc_version` string, required

## Other responses

- `422` — Unprocessable Entity

---

[API](https://skmtc.net/arcadia/apis/arcadia-api-reference.md) · [All operations](https://skmtc.net/arcadia/apis/arcadia-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arcadia/arcadia-api-reference/versions/468f1c903722/schema)