---
title: "Create Manual Dispatch"
description: "Use POST /webhooks/dispatch to queue a manual HTTP dispatch. The operation documented here is Webhook.manual_dispatch."
canonical: https://docs.ordering.co/api-reference/guides/create-manual-dispatch/
---

# Create Manual Dispatch

> **API operation:** [Open the endpoint in Scalar](https://docs.ordering.co/api-reference/#tag/webhooks/POST/webhooks/dispatch)

Use `POST /webhooks/dispatch` to queue a manual HTTP dispatch. The operation documented here is `Webhook.manual_dispatch`.

The documented schema requires administrator authentication. It validates a destination `url`, optional delay, JSON body, headers, and query parameters, then queues the request. The documented limit is `500` concurrent dispatches per project; check your project limit before queuing requests.

Outbound requests can disclose data or credentials. Use only approved destinations and never place secrets in documentation. See [Manual dispatch model](https://docs.ordering.co/api-reference/guides/manual-dispatch-model/).

## OpenAPI reference

**Operation:** `POST /webhooks/dispatch`

**Request body fields**

| Name           | Type    | Required |
| -------------- | ------- | -------- |
| `body`         | string  | No       |
| `delay`        | integer | No       |
| `headers`      | any     | No       |
| `query_params` | any     | No       |
| `url`          | any     | Yes      |

**Responses**

| Code | Description                           |
| ---- | ------------------------------------- |
| 200  | OK (Envelope)                         |
| 400  | Bad Request (ErrorResponse)           |
| 401  | Unauthorized                          |
| 404  | Not Found                             |
| 429  | Too Many Requests (ErrorResponse)     |
| 500  | Internal Server Error (ErrorResponse) |
| 503  | Service Unavailable (ErrorResponse)   |

[Open this operation in the API reference](https://docs.ordering.co/api-reference/#tag/webhooks/POST/webhooks/dispatch)