---
title: "POST /v1/webhooks"
method: POST
path: "/v1/webhooks"
tags: ["webhooks"]
---

# POST /v1/webhooks

`POST /v1/webhooks`

## Request

- Base URL: `https://apibusiness-staging-civ.djamo.io`
- URL: `https://apibusiness-staging-civ.djamo.io/v1/webhooks`
- Auth: HTTP bearer

## Request body

- WebhookParams
  - `topic` 'batches/failed' | 'batches/started' | 'batches/updated' | 'batches/completed' | 'transactions/completed' | 'transactions/failed' | 'transactions/started', required: Event that triggers the webhook. You can retrieve data in JSON.
  - `url` string, required: Destination URI to which the webhook subscription should send the POST request when an event occurs.

## Response `201`

- Webhook
  - `id` string, required: Universal Unique Identifier for the object.
  - `createdAt` string, required: Date and time when the object was created. The API returns this value in ISO 8601 format.
  - `updatedAt` string, required: Date and time when the object was updated. The API returns this value in ISO 8601 format.
  - `topic` 'batches/failed' | 'batches/started' | 'batches/updated' | 'batches/completed' | 'transactions/completed' | 'transactions/failed' | 'transactions/started', required: Event that triggers the webhook. You can retrieve data in JSON.
  - `url` string, required: Destination URI to which the webhook subscription should send the POST request when an event occurs.

## Other responses

- `400`

---

[API](https://skmtc.dev/djamo/apis/djamo-business-api-playground.md) - [All operations](https://skmtc.dev/djamo/apis/djamo-business-api-playground/llms.txt) - [OpenAPI document](https://skmtc.dev/djamo/apis/djamo-business-api-playground/revisions/e7f36f4cab53?raw)
