---
title: "Create Webhook Group"
method: POST
path: "/v1/webhooks/groups"
tags: ["Webhook Groups"]
---

# Create Webhook Group

`POST /v1/webhooks/groups`

Creates a webhook group.

## Headers

- `Idempotency-Key` string, required

## Request body

- CreateWebhookGroupRequest
  - `name` string, required — The name for the webhook group.

## Response `200`

Success

- WebhookGroup — A webhook group, which can be used by webhook subscriptions to target only the webhook group members. When an event occurs and it belongs to a member of the group, the webhooks will be sent only to the subscriptions that are associated with the group. If there is no group associated with the event, then the webhook will be sent to all subscriptions that are not associated with any group. Webhook groups are only available for partners.
  - `id` string, required — The ID of the webhook group.
  - `name` string, required — The name for the webhook group.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal server error

---

[API](https://skmtc.net/brex-com/apis/webhooks-api.md) · [All operations](https://skmtc.net/brex-com/apis/webhooks-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brex-com/webhooks-api/revisions/bc197ebb855c/schema)