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

# Register Webhook URL

`POST /webhooks`

## Request

- Base URL: `https://api-sandbox.tamara.co`
- URL: `https://api-sandbox.tamara.co/webhooks`
- Auth: HTTP bearer

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.dev/tamara/apis/tamara-public-apis-v1-0.md) - [All operations](https://skmtc.dev/tamara/apis/tamara-public-apis-v1-0/llms.txt) - [OpenAPI document](https://skmtc.dev/tamara/apis/tamara-public-apis-v1-0/revisions/aa481f4d0218?raw)