Poner a un cliente en la lista de espera

POST

https://app.recurrente.com/api/waitlist_entries

POST

/api/waitlist_entries

curl -X POST https://app.recurrente.com/api/waitlist_entries \
     -H "X-SECRET-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "service_id": "svc_9f8e7d6c",
  "days": [
    {
      "date": "2024-07-10"
    },
    {
      "date": "2024-07-11"
    }
  ]
}'

{
  "id": "wl_4a3b2c1d",
  "account_id": "ac_987654321",
  "status": "open",
  "service_id": "svc_9f8e7d6c",
  "staff_member_id": "stf_123abc456",
  "customer": {
    "id": "cus_789xyz123",
    "name": "María González",
    "email": "maria.gonzalez@example.com",
    "phone": "+5215512345678"
  },
  "days": [
    {
      "date": "2024-07-10",
      "part": "any"
    },
    {
      "date": "2024-07-11",
      "part": "morning"
    }
  ],
  "notified_at": "2024-06-20T14:45:00Z",
  "booking_id": "bk_56fgh78j",
  "created_at": "2024-06-15T10:00:00Z"
}

Pone a un cliente en la lista de espera de un servicio para uno o más días (hasta 5), cada uno entero o una parte (morning, afternoon, evening), como el “Avísame si se libera” de la página pública. Si el cliente ya espera ese servicio con el mismo profesional, los días se agregan a su lugar en la lista. Cuando se cancela o mueve una cita que le sirve, recibe un WhatsApp con el link para reservar.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Request

This endpoint expects an object.

service_idstringRequired

dayslist of objectsRequired

staff_member_idstringOptional

Solo con esta persona. Sin él, con quien sea.

customer_idstringOptional

customerobjectOptional

Response

El cliente en la lista de espera

idstringOptional

account_idstringOptional

statusenumOptional

Allowed values:

service_idstringOptional

staff_member_idstring or nullOptional

customerobjectOptional

dayslist of objectsOptional

notified_atdatetime or nullOptional

La última vez que se le avisó de una hora libre.

booking_idstring or nullOptional

La cita que tomó desde el aviso.

created_atdatetimeOptional

Errors

403

Forbidden Error

422

Unprocessable Entity Error