---
title: "Subscribe to Webhook Events"
method: POST
path: "/api/zapier/webhooks/subscribe"
tags: ["Webhooks"]
---

# Subscribe to Webhook Events

`POST /api/zapier/webhooks/subscribe`

## Request

- Base URL: `https://www.ordavia.com`
- URL: `https://www.ordavia.com/api/zapier/webhooks/subscribe`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ordavia/apis/ordavia-zapier-api/docs/api/zapier/webhooks/subscribe/post.ts> (a function with typed inputs; its response is checked against the schema)

Register a webhook URL to receive real-time notifications for specific events.

## Request body

- object
  - `hookUrl` string, uri, required: The URL where webhook payloads will be sent
  - `event` 'order.created' | 'order.status_changed' | 'product.low_stock', required: The event type to subscribe to

## Response `201`

Webhook subscription created successfully

- object
  - `webhook` object
    - `id` string, uuid
    - `event` string
    - `url` string, uri
    - `status` 'active'
    - `createdAt` string, date-time

## Other responses

- `400`: Invalid request parameters
- `401`: Invalid or missing API key

---

[API](https://skmtc.dev/ordavia/apis/ordavia-zapier-api.md) - [All operations](https://skmtc.dev/ordavia/apis/ordavia-zapier-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ordavia/apis/ordavia-zapier-api/revisions/88e20ed13b0d?raw)