---
title: "Create a reporting webhook"
method: POST
path: "/v1/reporting_webhooks"
tags: ["Reporting Webhooks"]
---

# Create a reporting webhook

`POST /v1/reporting_webhooks`

Create a new webhook configuration.

## Request body

- ReportingWebhook
  - `name` string, required — The name of your webhook.
  - `id` integer — The identifier for the webhook.
  - `type` 'webhook' | 'js' — The type of webhook—`webhook` for a standard reporting webhook or `js` for a JavaScript webhook.
  - `endpoint` string, url, required — The webhook URL.
  - `disabled` boolean — Set to `true` to quit sending events to the webhook URL. Set to `false` to enable the webhook.
  - `full_resolution` boolean — Set to `false` to send unique open and click events to the webhook. Set to `true` to send all events.
  - `with_content` boolean — Set to `true` to include the message `body` in `_sent` events.
  - `events` string[], required — Specifies the types of events you want to report to your webhook. See our [reporting webhooks reference](/integrations/api/webhooks/) for more information about event types and the information they return.

## Response `200`

Returns your webhook configuration and the ID of the webhook.

- ReportingWebhook
  - `name` string, required — The name of your webhook.
  - `id` integer — The identifier for the webhook.
  - `type` 'webhook' | 'js' — The type of webhook—`webhook` for a standard reporting webhook or `js` for a JavaScript webhook.
  - `endpoint` string, url, required — The webhook URL.
  - `disabled` boolean — Set to `true` to quit sending events to the webhook URL. Set to `false` to enable the webhook.
  - `full_resolution` boolean — Set to `false` to send unique open and click events to the webhook. Set to `true` to send all events.
  - `with_content` boolean — Set to `true` to include the message `body` in `_sent` events.
  - `events` string[], required — Specifies the types of events you want to report to your webhook. See our [reporting webhooks reference](/integrations/api/webhooks/) for more information about event types and the information they return.

## Other responses

- `400` — The request was malformed.
- `429` — Your request is over the 10-per-second limit.

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/4b391af7cb06/schema)