Update a booking event type

curl --request PATCH \
  --url https://api.simplepay.mx/v1/bookable-payments/event_types/{id_or_slug} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "active": true,
  "booking_form_fields": [
    {}
  ],
  "booking_window_days": 2,
  "buffer_after_minutes": 1,
  "buffer_before_minutes": 1,
  "cancellation_policy": {},
  "capacity": 2,
  "default_price_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": "<string>",
  "duration_choices_minutes": [
    2
  ],
  "duration_minutes": 2,
  "maximum_quantity": 2,
  "metadata": {},
  "minimum_notice_minutes": 1,
  "minimum_quantity": 2,
  "payment_config": {},
  "product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "resource_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "reschedule_policy": {},
  "schedule_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "slug": "<string>",
  "slot_interval_minutes": 2,
  "time_zone": "<string>",
  "title": "<string>"
}
'

const options = {
  method: 'PATCH',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    active: true,
    booking_form_fields: [{}],
    booking_window_days: 2,
    buffer_after_minutes: 1,
    buffer_before_minutes: 1,
    cancellation_policy: {},
    capacity: 2,
    default_price_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    description: '<string>',
    duration_choices_minutes: [2],
    duration_minutes: 2,
    maximum_quantity: 2,
    metadata: {},
    minimum_notice_minutes: 1,
    minimum_quantity: 2,
    payment_config: {},
    product_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    resource_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    reschedule_policy: {},
    schedule_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    slug: '<string>',
    slot_interval_minutes: 2,
    time_zone: '<string>',
    title: '<string>'
  })
};

fetch('https://api.simplepay.mx/v1/bookable-payments/event_types/{id_or_slug}', 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/{id_or_slug}"

payload = {
    "active": True,
    "booking_form_fields": [{}],
    "booking_window_days": 2,
    "buffer_after_minutes": 1,
    "buffer_before_minutes": 1,
    "cancellation_policy": {},
    "capacity": 2,
    "default_price_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "description": "<string>",
    "duration_choices_minutes": [2],
    "duration_minutes": 2,
    "maximum_quantity": 2,
    "metadata": {},
    "minimum_notice_minutes": 1,
    "minimum_quantity": 2,
    "payment_config": {},
    "product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "resource_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "reschedule_policy": {},
    "schedule_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "slug": "<string>",
    "slot_interval_minutes": 2,
    "time_zone": "<string>",
    "title": "<string>"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(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"
}

PATCH

https://api.simplepay.mx

bookable-payments

event_types

{id_or_slug}

Update a booking event type

curl --request PATCH \
  --url https://api.simplepay.mx/v1/bookable-payments/event_types/{id_or_slug} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "active": true,
  "booking_form_fields": [
    {}
  ],
  "booking_window_days": 2,
  "buffer_after_minutes": 1,
  "buffer_before_minutes": 1,
  "cancellation_policy": {},
  "capacity": 2,
  "default_price_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": "<string>",
  "duration_choices_minutes": [
    2
  ],
  "duration_minutes": 2,
  "maximum_quantity": 2,
  "metadata": {},
  "minimum_notice_minutes": 1,
  "minimum_quantity": 2,
  "payment_config": {},
  "product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "resource_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "reschedule_policy": {},
  "schedule_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "slug": "<string>",
  "slot_interval_minutes": 2,
  "time_zone": "<string>",
  "title": "<string>"
}
'

const options = {
  method: 'PATCH',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    active: true,
    booking_form_fields: [{}],
    booking_window_days: 2,
    buffer_after_minutes: 1,
    buffer_before_minutes: 1,
    cancellation_policy: {},
    capacity: 2,
    default_price_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    description: '<string>',
    duration_choices_minutes: [2],
    duration_minutes: 2,
    maximum_quantity: 2,
    metadata: {},
    minimum_notice_minutes: 1,
    minimum_quantity: 2,
    payment_config: {},
    product_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    resource_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    reschedule_policy: {},
    schedule_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    slug: '<string>',
    slot_interval_minutes: 2,
    time_zone: '<string>',
    title: '<string>'
  })
};

fetch('https://api.simplepay.mx/v1/bookable-payments/event_types/{id_or_slug}', 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/{id_or_slug}"

payload = {
    "active": True,
    "booking_form_fields": [{}],
    "booking_window_days": 2,
    "buffer_after_minutes": 1,
    "buffer_before_minutes": 1,
    "cancellation_policy": {},
    "capacity": 2,
    "default_price_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "description": "<string>",
    "duration_choices_minutes": [2],
    "duration_minutes": 2,
    "maximum_quantity": 2,
    "metadata": {},
    "minimum_notice_minutes": 1,
    "minimum_quantity": 2,
    "payment_config": {},
    "product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "resource_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "reschedule_policy": {},
    "schedule_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "slug": "<string>",
    "slot_interval_minutes": 2,
    "time_zone": "<string>",
    "title": "<string>"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(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	`PATCH`
Ruta	`/v1/bookable-payments/event_types/{id_or_slug}`
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 PATCH "https://api.simplepay.mx/v1/bookable-payments/event_types/experiencia-isla" \
  -H "Authorization: Bearer $SIMPLEPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: update-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.
404 significa que el recurso no existe para ese tenant o ambiente.
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

Path Parameters

id_or_slug

string

required

Body

application/json

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

duration_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

title

string

Minimum string length: 1

Response

200 - application/json

Booking event type updated

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

Retrieve a booking event type Archive 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

Update a booking event type

Uso

Antes de llamar

Patron recomendado

Ejemplo minimo

Errores a manejar

Contrato OpenAPI

Authorizations

Headers

Path Parameters

Body

Response

​Uso

​Antes de llamar

​Patron recomendado

​Ejemplo minimo

​Errores a manejar

​Contrato OpenAPI

Authorizations

Headers

Path Parameters

Body

Response

Uso

Antes de llamar

Patron recomendado

Ejemplo minimo

Errores a manejar

Contrato OpenAPI