---
title: "Crear un despacho manual | Documentación de Ordering.co"
description: "Usa POST /webhooks/dispatch para poner en cola un despacho HTTP manual."
canonical: https://docs.ordering.co/es/api-reference/guides/create-manual-dispatch/
---

# Crear un despacho manual

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

Usa `POST /webhooks/dispatch` para poner en cola un despacho HTTP manual. La operación descrita aquí es `Webhook.manual_dispatch`.

El esquema documentado requiere autenticación de administrador. Valida una `url` de destino, un `delay` opcional, un `body` JSON, `headers` y `query_params`, y después pone la solicitud en cola. El límite documentado es de `500` despachos simultáneos por proyecto; confirma el límite de tu proyecto antes de poner solicitudes en cola.

Las solicitudes salientes pueden divulgar datos o credenciales. Usa únicamente destinos aprobados y nunca incluyas secretos en la documentación. Consulta [Modelo de despacho manual](https://docs.ordering.co/es/api-reference/guides/manual-dispatch-model/).

## Referencia de OpenAPI

**Operación:** `POST /webhooks/dispatch`

**Campos del cuerpo de la solicitud**

| Nombre         | Tipo    | Obligatorio |
| -------------- | ------- | ----------- |
| `body`         | string  | No          |
| `delay`        | integer | No          |
| `headers`      | any     | No          |
| `query_params` | any     | No          |
| `url`          | any     | Sí          |

**Respuestas**

| Código | Descripción                                                                                                                                                                                                                                                                        |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200    | Respuesta exitosa. El contenido de `result` varía según la operación y se devuelve como JSON.                                                                                                                                                                                      |
| 400    | Respuesta de error (error=true). Los errores de validación y de negocio comparten este código.                                                                                                                                                                                     |
| 401    | Respuesta de error: sesión ausente, inválida, o nivel de usuario fuera de los permitidos. Respuesta de error: el proyecto no existe o no tiene una suscripción activa.                                                                                                             |
| 404    | Respuesta vacía: la versión de API solicitada no está admitida.                                                                                                                                                                                                                    |
| 429    | Envelope de error: se excedió un límite de consumo del proyecto (o el sujeto está baneado). Lleva Retry-After y X-RateLimit-Limit/Remaining/Reset/Scope/Key.                                                                                                                       |
| 500    | Respuesta de error: falló la búsqueda o inicialización del proyecto.                                                                                                                                                                                                               |
| 503    | Envelope de error: la aplicación está temporalmente en mantenimiento. Envelope de error: el proyecto está temporalmente en mantenimiento, o los límites de consumo no se pudieron evaluar y el límite aplicable está configurado con on\_error = closed (cabecera Retry-After: 1). |

[Abrir esta operación en la Referencia de la API](https://docs.ordering.co/es/api-reference/#tag/webhooks/POST/webhooks/dispatch)