---
title: "Register Webhook URL"
method: POST
path: "/webhooks"
tags: ["Webhooks"]
---

# Register Webhook URL

`POST /webhooks`

Register a new webhook endpoint that Tamara will post selected events to as notification payload

## Request body

- union
  - object
    - `type` string, required
    - `events` string[], required — Select the events you would like to be sent webhook notifications for
    - `url` string, uri, required — Your webhook endpoint to receive notifications from Tamara when order information is updated (order status changes), please use https only.
    - `headers` object — Add any optional headers you need, the authorization header is only an example.
      - `authorization` string
  - object
    - `type` string, required
    - `events` string[], required — Select the events you would like to be sent webhook notifications for
    - `url` string, uri, required — Your webhook endpoint to receive notifications from Tamara when dispute case information is updated (dispute case status changes), please use https only.
    - `headers` object — Add any optional headers you need, the authorization header is only an example.
      - `authorization` string

## Response `200`

Success

---

[API](https://skmtc.net/tamara/apis/tamara-public-apis-v1-0.md) · [All operations](https://skmtc.net/tamara/apis/tamara-public-apis-v1-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tamara/tamara-public-apis-v1-0/revisions/924ade2a1159/schema)