---
title: "Create webhook configurations"
method: POST
path: "/webhooks"
tags: ["Webhooks"]
---

# Create webhook configurations

`POST /webhooks`

This endpoint create webhook configurations.

## Query parameters

- `org_id` integer

## Request body

- CreateWebhooksPayload
  - `items` CreateWebhookPayloadItem[], required — The list of webhook configurations to create.
    - `url` string, required — The URL receiving the webhook's data. Only HTTPS URLs are supported.
    - `event_type` string, required — The webhook event type.
    - `custom_headers` CustomHeaders — Custom HTTP headers to include in webhook requests. Keys must start with `X-` (case-insensitive) and must not use the reserved `X-Partoo` prefix. Maximum 5 headers. Key max length: 128 characters. Value max length: 512 characters. The following characters are forbidden in header keys: space, `(`, `)`, `<`, `>`, `@`, `,`, `;`, `:`, `\`, `"`, `/`, `[`, `]`, `?`, `=`, `{`, `}`.

## Response `200`

OK

- object
  - `items` WebhookItem[] — List of created webhook configurations
    - `id` integer, required — The identifier for the webhook configuration.
    - `url` string, required — The URL receiving the webhook's data.
    - `event_type` 'business_created' | 'business_updated' | 'business_deleted' | 'message_updated' | 'message_created' | 'lead_received', required — The webhook event type.
    - `created_at` string, required — An ISO 8601 date-time string representing the webhook creation date.
    - `updated_at` string, required — An ISO 8601 date-time string representing the webhook last update date.
    - `org_id` integer, required — The organization identifier for the webhook configuration.
    - `custom_headers` CustomHeaders — Custom HTTP headers to include in webhook requests. Keys must start with `X-` (case-insensitive) and must not use the reserved `X-Partoo` prefix. Maximum 5 headers. Key max length: 128 characters. Value max length: 512 characters. The following characters are forbidden in header keys: space, `(`, `)`, `<`, `>`, `@`, `,`, `;`, `:`, `\`, `"`, `/`, `[`, `]`, `?`, `=`, `{`, `}`.

## Other responses

- `400` — Your request is incorrect
- `403` — You are not allowed to perform this action
- `404` — Resource does not exist

---

[API](https://skmtc.net/partoo/apis/partoo-rest-api.md) · [All operations](https://skmtc.net/partoo/apis/partoo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/partoo/partoo-rest-api/revisions/3652d8b1a8b3/schema)