# Disparar un evento de prueba

POST `https://api.bydomu.com/v1/test/events`

This reference is generated from the API’s code, so descriptions are in Spanish. Names, parameters and examples are the same in every language.

Encola la entrega de un evento del catálogo (`GET /v1/events`) a los webhooks de la organización de prueba suscritos a ese tipo, por la misma cola con reintentos y con la misma firma `X-Domu-Signature` que un evento real. Los datos salen del registro más reciente de ese objeto en la organización de prueba; si no hay ninguno, van con la forma del catálogo y valores nulos (`synthetic: true`). El sobre lleva `livemode: false` y `test: true`. Solo con una clave de prueba: con una de producción responde `403 TEST_MODE_ONLY`.

Permission required

`webhooks:write`

Required header

`X-API-Key` · secret key

Access level

Level 3 · with support review

## Headers

1 · all optional

`Idempotency-Key` string · optional

Clave única de la operación (8-128 caracteres de `[a-zA-Z0-9._:-]`). Un reintento con la misma clave y el mismo cuerpo devuelve la respuesta original sin repetir la operación. Vive 24 horas. 8–128 chars

## Body (JSON)

1 · required

`type` string · **required**

1–100 chars

## Response 201

`TestEvent` · 5 fields

**`data` id · type · livemode · webhooks · synthetic**

`id` string Id del evento de prueba (`evt_test_…`)

`type` string

`livemode` boolean false

`webhooks` integer Webhooks suscritos a ese tipo a los que se encoló la entrega

`synthetic` boolean `true` si no había registros de ese objeto y los datos van con valores nulos

## Possible errors

shaped as `{ "error": { "code", "message" } }`

- **400** Datos inválidos: el cuerpo o la query no cumplen el esquema, o `Idempotency-Key` está mal formada.
- **401** UNAUTHORIZED
- **402** PAYMENT_REQUIRED
- **403** FORBIDDEN
- **404** NOT_FOUND
- **409** DUPLICATE
- **429** RATE_LIMITED
- **500** INTERNAL_ERROR

cURL:

```bash
curl -X POST "https://api.bydomu.com/v1/test/events" \
  -H "X-API-Key: $BYDOMU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "deal.won"
}'
```

JavaScript:

```js
import { ByDomu } from "@bydomu/sdk";

const bydomu = new ByDomu({
  apiKey: process.env.BYDOMU_API_KEY,
});

const { data } = await bydomu.test.triggerEvent({
  "type": "deal.won"
});
```

Python:

```python
import os, requests

r = requests.post(
    "https://api.bydomu.com/v1/test/events",
    headers={"X-API-Key": os.environ["BYDOMU_API_KEY"]},
    json={
        "type": "deal.won"
    }
)
data = r.json()
```

**Response · 201 · example**

```json
{
  "data": {
    "id": "evt_test_5f3a0c1e7d2b4f7e9a510b6c1d2e3f40",
    "type": "deal.won",
    "livemode": false,
    "webhooks": 1,
    "synthetic": false
  }
}
```