---
title: "Create or Update Webhook"
method: POST
path: "/stores/{storeId}/webhooks"
tags: ["Webhooks"]
---

# Create or Update Webhook

`POST /stores/{storeId}/webhooks`

Create webhook for store. Or if webhook already exists with `externalId`, update it. Requires the [`webhooks_write`](/docs/api-reference/scopes) scope.

## Request body

- object
  - `webhook` WebhookCreateSchema — Webhook create.
    - `backfill` boolean — Create events for already-existing items
    - `callback` HttpsCallbackSchema, required — HTTPS callback
      - `auth` object, nullable, required — Authorization.
        - `bearer` object — Bearer
          - `token` string, password — Token for Bearer authorization.
      - `url` string, uri, required — HTTPS callback URL.
    - `externalId` string, nullable — Optional external identifier.
    - `kind` 'redo' | 'loop' — Webhook kind.
    - `topic` 'return', required — Webhook topic.

## Response `200`

Updated

- object
  - `webhook` WebhookReadSchema — Webhook read.
    - `callback` HttpsCallbackSchema, required — HTTPS callback
      - `auth` object, nullable, required — Authorization.
        - `bearer` object — Bearer
          - `token` string, password — Token for Bearer authorization.
      - `url` string, uri, required — HTTPS callback URL.
    - `createdAt` string, date-time, required — Time created.
    - `externalId` string, nullable — Optional external identifier.
    - `id` string — Webhook ID.
    - `kind` 'redo' | 'loop' — Webhook kind.
    - `topic` 'return', required — Webhook topic.
    - `updatedAt` string, date-time, required — Last time updated.

## Other responses

- `201` — Created
- `default` — Error

---

[API](https://skmtc.dev/redoapp/apis/redo-api.md) · [All operations](https://skmtc.dev/redoapp/apis/redo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redoapp/redo-api/revisions/119714540a45/schema)