---
title: "Create a Webhook"
method: POST
path: "/v2/webhook"
tags: ["Webhook"]
---

# Create a Webhook

`POST /v2/webhook`

## Request

- Base URL: `https://api.starkbank.com`
- URL: `https://api.starkbank.com/v2/webhook`
- Auth: API key in header `Digital-Signature`

Here you can register a new webhook URL. The subscriptions refer to which kinds of logs will be sent to the webhook URL being registered. The subscriptions must be in transfer, boleto, boleto-payment, utility-payment, brcode-payment, boleto-holmes, deposit, darf-payment, tax-payment, payment-request, verified-account, corporate-purchase, corporate-card, merchant-purchase, merchant-installment, merchant-card, invoice-pull-subscription, invoice-pull-request or invoice.

## Request body

- object
  - `subscriptions` string[], required: Array of subscriptions. Possible values: "deposit", "invoice", "invoice-pull-subscription", "invoice-pull-request", "brcode-payment", "transfer", "utility-payment", "boleto", "boleto-payment", "darf-payment", "tax-payment", "payment-request", "verified-account", "corporate-purchase", "corporate-card", "merchant-purchase", "merchant-installment", "merchant-card" or "boleto-holmes"
  - `url` string, required: The server URL that will receive the Webhook Events.

## Response `200`

Successful operation

- object

## Other responses

- `400`: Client error
- `500`: Server error

---

[API](https://skmtc.dev/starkbank/apis/stark-bank-api.md) - [All operations](https://skmtc.dev/starkbank/apis/stark-bank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starkbank/apis/stark-bank-api/revisions/aeff5068a5da?raw)