Create a booking event type

curl --request POST \
  --url https://api.simplepay.mx/v1/bookable-payments/event_types \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "duration_minutes": 2,
  "title": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({duration_minutes: 2, title: '<string>'})
};

fetch('https://api.simplepay.mx/v1/bookable-payments/event_types', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.simplepay.mx/v1/bookable-payments/event_types"

payload = {
    "duration_minutes": 2,
    "title": "<string>"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "active": true,
  "bookingFormFields": [
    {}
  ],
  "bookingWindowDays": 2,
  "bufferAfterMinutes": 1,
  "bufferBeforeMinutes": 1,
  "cancellationPolicy": {},
  "capacity": 2,
  "defaultPrice": {
    "amount": 1,
    "currency": "<string>",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "defaultPriceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": "<string>",
  "durationChoicesMinutes": [
    2
  ],
  "durationMinutes": 2,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "maximumQuantity": 2,
  "metadata": {},
  "minimumNoticeMinutes": 1,
  "minimumQuantity": 2,
  "object": "<unknown>",
  "paymentConfig": {},
  "product": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "reschedulePolicy": {},
  "slug": "<string>",
  "slotIntervalMinutes": 2,
  "timeZone": "<string>",
  "title": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z"
}

POST

https://api.simplepay.mx

bookable-payments

event_types

Create a booking event type

curl --request POST \
  --url https://api.simplepay.mx/v1/bookable-payments/event_types \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "duration_minutes": 2,
  "title": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({duration_minutes: 2, title: '<string>'})
};

fetch('https://api.simplepay.mx/v1/bookable-payments/event_types', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.simplepay.mx/v1/bookable-payments/event_types"

payload = {
    "duration_minutes": 2,
    "title": "<string>"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "active": true,
  "bookingFormFields": [
    {}
  ],
  "bookingWindowDays": 2,
  "bufferAfterMinutes": 1,
  "bufferBeforeMinutes": 1,
  "cancellationPolicy": {},
  "capacity": 2,
  "defaultPrice": {
    "amount": 1,
    "currency": "<string>",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "defaultPriceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": "<string>",
  "durationChoicesMinutes": [
    2
  ],
  "durationMinutes": 2,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "maximumQuantity": 2,
  "metadata": {},
  "minimumNoticeMinutes": 1,
  "minimumQuantity": 2,
  "object": "<unknown>",
  "paymentConfig": {},
  "product": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "reschedulePolicy": {},
  "slug": "<string>",
  "slotIntervalMinutes": 2,
  "timeZone": "<string>",
  "title": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Uso

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

Antes de llamar

Tema	Detalle
Metodo	`POST`
Ruta	`/v1/bookable-payments/event_types`
Auth	Bearer API key del ambiente correcto.
Scope	`availability:write`
Idempotencia	Recomendada para cualquier retry. Usa una key deterministica por operacion de negocio.
Guia relacionada	Bookable Payments

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

curl -sS -X POST "https://api.simplepay.mx/v1/bookable-payments/event_types" \
  -H "Authorization: Bearer $SIMPLEPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-booking-event-type_v1" \
  -d '{ ... }'

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

duration_minutes

integer

required

Required range: x >= 1

title

string

required

Minimum string length: 1

active

boolean

booking_form_fields

object[]

booking_window_days

integer | null

Required range: x >= 1

buffer_after_minutes

integer

Required range: x >= 0

buffer_before_minutes

integer

Required range: x >= 0

cancellation_policy

object

capacity

integer

Required range: x >= 1

confirmation_policy

enum<string>

Available options:

automatic,

manual,

payment_required

default_price_id

string<uuid> | null

description

string | null

duration_choices_minutes

integer[]

Required range: x >= 1

inventory_mode

enum<string>

Available options:

capacity_pool,

date_range,

instant,

seated,

unit_assignment

kind

enum<string>

Available options:

appointment,

class,

scheduled_offer,

experience,

rental,

service,

date_range

maximum_quantity

integer | null

Required range: x >= 1

metadata

object

minimum_notice_minutes

integer

Required range: x >= 0

minimum_quantity

integer

Required range: x >= 1

payment_config

object

payment_requirement

enum<string>

Available options:

deposit,

none,

optional,

required

product_id

string<uuid> | null

resource_ids

string<uuid>[]

reschedule_policy

object

schedule_ids

string<uuid>[]

slug

string

Pattern: ^[a-z0-9][a-z0-9-]{1,120}$

slot_interval_minutes

integer

Required range: x >= 1

time_zone

string

Response

201 - application/json

Booking event type created

active

boolean

bookingFormFields

object[]

bookingWindowDays

integer

Required range: x >= 1

bufferAfterMinutes

integer

Required range: x >= 0

bufferBeforeMinutes

integer

Required range: x >= 0

cancellationPolicy

object

capacity

integer

Required range: x >= 1

confirmationPolicy

enum<string>

Available options:

automatic,

manual,

payment_required

defaultPrice

object

Hide child attributes

defaultPrice.amount

integer

Required range: x >= 0

defaultPrice.currency

string

Pattern: ^[a-z]{3}$

defaultPrice.id

string<uuid>

defaultPriceId

string<uuid>

description

string

durationChoicesMinutes

integer[]

Required range: x >= 1

durationMinutes

integer

Required range: x >= 1

string<uuid>

inventoryMode

enum<string>

Available options:

capacity_pool,

date_range,

instant,

seated,

unit_assignment

kind

enum<string>

Available options:

appointment,

class,

scheduled_offer,

experience,

rental,

service,

date_range

maximumQuantity

integer

Required range: x >= 1

metadata

object

minimumNoticeMinutes

integer

Required range: x >= 0

minimumQuantity

integer

Required range: x >= 1

object

any

paymentConfig

object

paymentRequirement

enum<string>

Available options:

deposit,

none,

optional,

required

product

object

Hide child attributes

product.id

string<uuid>

product.name

string

productId

string<uuid>

reschedulePolicy

object

slug

string

slotIntervalMinutes

integer

Required range: x >= 1

timeZone

string

title

string

updatedAt

string<date-time>

Last modified on June 21, 2026

List booking event types Retrieve a booking event type

Overview

Checkout

Payment Links

Refunds

Payment Policy

Products

Catalog

Customer Hub

Bookable: setup

Bookable: resources

Bookable: disponibilidad

Bookable: event types

Bookable: holds y bookings

Webhooks y eventos

Meta

Create a booking event type

Uso

Antes de llamar

Patron recomendado

Ejemplo minimo

Errores a manejar

Contrato OpenAPI

Authorizations

Headers

Body

Response

​Uso

​Antes de llamar

​Patron recomendado

​Ejemplo minimo

​Errores a manejar

​Contrato OpenAPI

Authorizations

Headers

Body

Response

Uso

Antes de llamar

Patron recomendado

Ejemplo minimo

Errores a manejar

Contrato OpenAPI