Skip to main content
POST
Create a Bookable Payments scheduling setup preset

Uso

Usalo dentro de Bookable Payments para modelar inventario reservado, calcular disponibilidad, crear holds, convertirlos en checkout y confirmar bookings.

Antes de llamar

Patron recomendado

  • Ejecuta este endpoint desde backend o job seguro, nunca desde frontend con API keys.
  • Manda Idempotency-Key cuando el endpoint cree, convierta, reprograme, cancele, capture o reembolse estado.
  • Confirma inventario final con booking.confirmed o una lectura de booking, no solo con una URL de retorno.
  • Consulta el bloque OpenAPI de esta pagina para el shape exacto de parametros, body y respuestas.

Ejemplo minimo

terminal

Errores a manejar

  • 400 indica payload, parametros o estado invalido.
  • 401 o 403 indican API key, ambiente o scopes incorrectos.
  • 409 suele indicar conflicto de estado, duplicado o idempotencia incompatible.
  • 429 y 5xx se pueden reintentar con backoff; en writes conserva la misma idempotency key.

Contrato OpenAPI

El playground, parametros, body y respuestas de abajo salen de /openapi.json. Si el contrato cambia, actualiza la spec y regenera esta pagina.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string
required
Required string length: 8 - 255

Body

application/json
name
string
required
Minimum string length: 1
price
object
required
capacity
integer
Required range: x >= 1
event_type
object
product
object
resource
object
schedule
object
time_zone
string
use_case
enum<string>
Available options:
appointment,
class,
scheduled_offer,
experience,
rental,
service,
date_range,
tour

Response

201 - application/json

Bookable Payments setup created

blueprint
object
event_type
object
next
object
object
any
product
object
resource
object
schedule
object
tenant_env
string
Last modified on June 21, 2026