Registra suscripciones de webhooks salientes y envía cargas útiles de prueba. Solo API key.

POST/v1/webhook-subscription/API key

Create a webhook subscription (API-Key only)

Body: url, subscriptions. Event types include FOLLOWUPS_DAILY_FINISHED, FORMS_RESPONSE_CREATED.

Errores

Estado	Cuándo
401	Missing/invalid/expired credential
403	Authenticated but not permitted
429	Throttled - Retry-After header set
400	Validation error

curl -sS -X POST 'https://api.dailybot.com/v1/webhook-subscription/' -H 'X-API-KEY: $DAILYBOT_API_KEY'

Probarlo

Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.

POST/v1/webhook-subscription/sample/API key

Deliver a sample event (API-Key only)

Body: event_type, url.

Errores

Estado	Cuándo
401	Missing/invalid/expired credential
403	Authenticated but not permitted
429	Throttled - Retry-After header set
400	Validation error

curl -sS -X POST 'https://api.dailybot.com/v1/webhook-subscription/sample/' -H 'X-API-KEY: $DAILYBOT_API_KEY'

Probarlo

Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.

API de Webhooks

Crea y gestiona suscripciones a webhooks programáticamente. Solicita payloads de muestra para probar tus integraciones.

Consulta la guía de Webhooks y Eventos para la lista completa de eventos soportados y estructuras de payload.

Resumen de endpoints

Método	Endpoint	Descripción
POST	`/v1/webhooks/`	Crear una suscripción a webhook
DELETE	`/v1/webhooks/{id}/`	Eliminar una suscripción a webhook
POST	`/v1/webhooks/{id}/sample/`	Solicitar un payload de muestra

POST /v1/webhooks/

Crea una nueva suscripción a webhook.

Parámetros del cuerpo

Nombre	Tipo	Requerido	Descripción
`url`	string (URL)	Sí	URL para recibir los payloads del webhook. Debe usar HTTPS.
`events`	array de strings	Sí	Tipos de eventos a suscribir (por ejemplo, `["followups.response.completed"]`).
`name`	string	No	Nombre descriptivo para el webhook.
`bearer_token`	string	No	Bearer token enviado como header `X-BEARER` para verificación de firma.
`object_ids`	array de strings	No	UUIDs específicos de check-in o formulario para filtrar eventos (opcional).
`immediate_sample_event`	boolean	No	Si es true, enviar un evento de prueba inmediatamente después de la creación.

curl -X POST "https://api.dailybot.com/v1/webhooks/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://tu-app.com/webhooks/dailybot",
    "events": ["followups.response.completed", "kudos.posted"],
    "name": "Webhook de Producción",
    "bearer_token": "tu-token-secreto",
    "immediate_sample_event": true
  }'

Respuesta (201 Created):

{
  "id": "wh-1234-abcd",
  "url": "https://tu-app.com/webhooks/dailybot",
  "events": ["followups.response.completed", "kudos.posted"],
  "name": "Webhook de Producción",
  "created_at": "2026-04-06T10:00:00Z"
}

DELETE /v1/webhooks/{id}/

Elimina una suscripción a webhook.

curl -X DELETE "https://api.dailybot.com/v1/webhooks/wh-1234-abcd/" \
  -H "X-API-KEY: tu_api_key"

Respuesta (204 No Content)

POST /v1/webhooks/{id}/sample/

Solicita un payload de muestra para un tipo de evento específico. Útil para probar tu endpoint.

Parámetros del cuerpo

Nombre	Tipo	Requerido	Descripción
`event`	string	Sí	El tipo de evento para el que generar una muestra.

curl -X POST "https://api.dailybot.com/v1/webhooks/wh-1234-abcd/sample/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"event": "followups.response.completed"}'

Respuesta (200 OK):

{
  "status": "sent",
  "event": "followups.response.completed",
  "message": "Sample event payload sent to your webhook URL."
}

Eventos soportados

Evento	Categoría
`followups.response.completed`	Check-in
`followups.response.updated`	Check-in
`followups.response.deleted`	Check-in
`forms.response.created`	Formularios
`forms.response.updated`	Formularios
`forms.response.deleted`	Formularios
`kudos.posted`	Kudos
`organization.user_activated`	Organización
`organization.user_deactivated`	Organización
`organization.team_user_added`	Organización
`organization.team_user_removed`	Organización