---
title: "Create a Webhook Callback"
method: POST
path: "/v1/webhook-callbacks"
tags: ["Webhooks"]
---

# Create a Webhook Callback

`POST /v1/webhook-callbacks`

Register a callback to be used for webhooks

## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage company resources (`company_admin`) | - | Manage webhooks (`webhook:write`) |

## Headers

- `Authorization` string, required

## Request body

- CreateWebhookCallbackParams — Webhook callback creation params. Provide either `subscribed_events` or `subscribe_to_all_events: true` (they are mutually exclusive).
  - `subscribe_to_all_events` boolean — When true, subscribe this callback to all current and future event types. Cannot be combined with `subscribed_events`.
  - `subscribed_events` string[]
  - `url` string, required

## Response `200`

Success

- WebhookCallbackResponse — Webhook callback response
  - `data` object, required
    - `webhook_callback` WebhookCallback, required — A registered webhook callback endpoint. Remote sends HTTP POST requests to the configured URL when subscribed events occur.
      - `id` string, required — The unique identifier (UUID) of the webhook callback.
      - `signing_key` string — This key will be used to sign the signature provided with webhook requests we send to the `url` you provided for this webhook callback. The webhook signature will be included in a custom header, `X-Remote-Signature`. You can use this signature to verify that requests are coming from Remote and not some unauthorized third-party.
      - `subscribe_to_all_events` boolean — When true, this callback is subscribed to all current and future event types. `subscribed_events` then lists every currently supported event.
      - `subscribed_events` string[]
      - `url` string, required — The HTTPS URL where Remote will send webhook event payloads.

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/versions/7e6a0c61ac82/schema)