---
title: "Get a list of webhook configurations"
method: GET
path: "/webhooks"
tags: ["Webhooks"]
---

# Get a list of webhook configurations

`GET /webhooks`

This endpoint returns the list of webhook configurations.

## Query parameters

- `org_id` integer
- `page` integer
- `per_page` integer

## Response `200`

OK

- object
  - `page` integer — Current page number
  - `max_page` integer — Last page number
  - `count` integer — Number of resources complying with filters
  - `items` WebhookItem[] — List of 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

- `401` — You are not authenticated
- `403` — You are not allowed to perform this action

---

[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/versions/3652d8b1a8b3/schema)