Skip to navigation
Referencia APIBookings

Agregar a una persona al equipo

Agrega a alguien con quien se reserva. Sin bookable: false, recibe reservas de inmediato en los servicios de service_ids, con el horario del negocio hasta que le des uno propio. La foto, la cuenta con la que ve su propia agenda y su perfil en otras sucursales se configuran en el panel.

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.
namestringRequired<=60 characters
biostringOptional<=280 characters
colorstringOptional

Color en la agenda, hexadecimal. Sin él, uno de la paleta.

bookablebooleanOptional
Si recibe reservas.
commission_percentdoubleOptional0-100
positionintegerOptional
service_idslist of stringsOptional

Los servicios que atiende (IDs svc_ o de producto). Reemplaza la lista.

Response

Persona agregada
idstringOptional
account_idstringOptional
namestringOptional
biostring or nullOptional
colorstringOptional
bookablebooleanOptional
Si recibe reservas ahora.
commission_percentdouble or nullOptional

Su comisión sobre lo que atiende, para el reporte del equipo.

positionintegerOptional

Su lugar en la lista del equipo y en la página pública.

service_idslist of stringsOptional
created_atdatetimeOptional

Errors

404
Not Found Error
422
Unprocessable Entity Error