Referencia de la API

Autenticación

Crea un token en tu espacio de trabajo en Ajustes → Desarrolladores (propietarios y administradores). Se muestra una sola vez, así que guárdalo en los secretos de tu servidor, nunca en una página web ni en una app que la gente descargue. Envíalo en el encabezado Authorization:

curl https://weesify.com/api/v1/workspace \
  -H "Authorization: Bearer wsy_your_token"

Un token pertenece a un espacio de trabajo. En cada llamada solo puede hacer lo que permiten sus permisos y lo que la persona que lo creó todavía puede hacer: si se va o cambia su rol, el token también cambia. Revoca un token cuando quieras; deja de funcionar al instante.

¿Vienes de la antigua API de Weesify? Tu antigua clave de API sigue funcionando aquí, como token bearer, durante 90 días tras el cambio, con el mismo alcance que tenía la API antigua. Crea un nuevo token antes; Ajustes → Desarrolladores muestra cuándo caduca tu clave antigua.

Inicio rápido

Sirve cualquier cliente HTTP. Tres llamadas cubren lo básico: leer, crear con seguridad y comprobar tu cupo.

# 1. Tus enlaces más recientes
curl "https://weesify.com/api/v1/links?limit=5" \
  -H "Authorization: Bearer $WEESIFY_TOKEN"

# 2. Crea uno (un reintento con la misma clave nunca crea dos)
curl -X POST https://weesify.com/api/v1/links \
  -H "Authorization: Bearer $WEESIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: signup-2026-1042" \
  -d '{"destination_url": "https://example.com/offer"}'

# 3. Consulta los encabezados de límite de uso
curl -i https://weesify.com/api/v1/workspace -H "Authorization: Bearer $WEESIFY_TOKEN"

Todas las respuestas son JSON. Un elemento llega como {"data": {…}}; una lista, como {"data": […], "meta": {…}}.

Alcances

Alcance	Permite al token
links:read	Enlaces cortos y sus clics
links:write	Crear, modificar y eliminar enlaces cortos
qr:read	Códigos QR y sus escaneos
qr:write	Crear, modificar y eliminar códigos QR
contacts:read	Contactos, sus etiquetas y datos
contacts:write	Añadir, actualizar, etiquetar y eliminar contactos
forms:read	Formularios y lo que la gente envió
store:read	Productos y pedidos (con los datos de los compradores)
sites:read	Your pages, HTML websites, their files, deployments, domains and usage
sites:write	Create HTML websites, upload and change files, settings and custom domains
sites:deploy	Publish HTML websites and roll them back
analytics:read	Clics y vistas a lo largo del tiempo
events:read	Eventos, fechas, tipos de entrada, agenda, ponentes, patrocinadores, expositores y lugares
events:write	Crear y modificar eventos y avanzarlos en su ciclo de vida
events:attendees	Inscripciones, asistentes, entradas y pedidos de entradas (con los datos de las personas)
events:checkin	Escanear entradas y leer registros de entrada
bookings:read	Bookable services and bookings (with people’s details)
courses:read	Courses and their students’ enrolments and progress
webhooks:read	Webhook endpoints and their delivery log
webhooks:write	Add, change, test and remove webhook endpoints, and send deliveries again
blog:read	Blog posts (drafts included) and categories

Solicitudes y páginas

Envía cuerpos JSON con Content-Type: application/json. Las horas están en ISO 8601 en UTC. Los ids son cadenas de 26 caracteres.
Las listas vienen de la más reciente a la más antigua como {"data": [...], "meta": {"limit": 25, "next_cursor": "…"}}. Pasa ?cursor= para obtener la página siguiente y ?limit= (1–100, 25 por defecto).
El dinero está en la unidad más pequeña (céntimos) con su moneda.

Errores

Los errores usan RFC 7807 (application/problem+json). Los errores de validación muestran cada campo en errors.

{
  "type": "https://weesify.com/developers#errors",
  "title": "Invalid request",
  "status": 422,
  "detail": "Some fields need attention.",
  "errors": { "destination_url": ["Enter a web address."] }
}

Estado	Medio
401	No hay token, o es incorrecto, ha vencido o fue revocado
402	El espacio de trabajo es de solo lectura hasta que elijas un plan o se alcance el límite de un plan
403	El token no tiene el permiso, la persona que lo creó no puede hacer esto, o el acceso a la API no está incluido en el plan
404	No se encontró en este espacio de trabajo, o esa función está desactivada
400	El Idempotency-Key no tiene el formato correcto
409	La misma Idempotency-Key todavía se está procesando, o se usó para una solicitud diferente
422	Algo en la solicitud no es correcto
429	Demasiadas solicitudes: espera los segundos de `Retry-After`

Límites de solicitudes

Cada token puede hacer 120 solicitudes por minuto y cada espacio de trabajo 600, contadas en ventanas de un minuto. Los planes Enterprise y Custom permiten más. Si superas el límite recibes un 429 con Retry-After: espera esos segundos e inténtalo de nuevo.

Encabezado	Medio
X-RateLimit-Limit	Requests a minute this token may make
X-RateLimit-Remaining	Requests left this minute
X-RateLimit-Reset	Unix time when the minute resets
RateLimit	IETF form: limit, remaining, reset (seconds)
RateLimit-Policy	The policy, e.g. 120;w=60
X-Request-Id	This request’s id, as shown in your request log

El registro de solicitudes de tu espacio de trabajo y el uso frente a tu plan están en Ajustes → Desarrolladores → Uso y registros, enlazados por X-Request-Id.

Reintentos

Envía una cabecera Idempotency-Key (de 1 a 80 letras, dígitos, guiones, puntos, dos puntos o guiones bajos) con un POST. Si la red se cae y reintentas con la misma clave, ruta y cuerpo en un plazo de 24 horas, obtienes de nuevo la respuesta original (marcada con Idempotent-Replayed: true) y nada se ejecuta dos veces. Las claves pertenecen al token que las envió. La misma clave con otra ruta o cuerpo recibe un 409.

Weesify CLI

Despliega una carpeta en un sitio web HTML desde tu ordenador o tu CI, tráela de vuelta, compara y revierte. Un solo archivo de Node.js 18+ sin paquetes: descárgalo y ejecútalo.

curl -fsSLo weesify.mjs https://weesify.com/developers/cli/weesify.mjs && node weesify.mjs login
node weesify.mjs init
node weesify.mjs deploy -m "Primera versión"

SHA-256 del archivo actual: e98494277685934e20bdfb05c7f9fe5087db5db66d80b2365a4d3f74ed51c8af

Instalación en macOS, Linux o Windows, todos los comandos, CI y códigos de salida →

Webhooks

Añade un endpoint en Ajustes → Desarrolladores → Webhooks (o con POST /webhooks) y elige los eventos. Weesify envía JSON por POST a medida que ocurren las cosas, reintenta los fallos 6 veces durante unas 21 horas y guarda un registro de entregas de 30 días desde el que puedes reenviar. Si 5 eventos seguidos no se pueden entregar, el endpoint se desactiva y se avisa a los administradores del espacio de trabajo. Responde con cualquier 2xx en 5 segundos; las redirecciones no se siguen.

{
  "id": "evt_01j…",
  "event": "order.paid",
  "created_at": "2026-10-31T09:30:00+00:00",
  "workspace": { "id": "01j…" },
  "data": {
    "contact": { "id": "01j…", "email": "ada@example.com", "name": "Ada", "subscribed": true, "tags": [] },
    "details": { "order": "W-1042", "product": "Preset pack" }
  }
}

Comprueba la firma. El encabezado X-Weesify-Signature es t=<unix time>,v1=<hex>. Calcula el HMAC-SHA256 de t + "." + cuerpo sin procesar con el secreto de firma de tu endpoint y compáralo (en tiempo constante) con cualquier v1: durante un día después de rotar el secreto hay dos. Rechaza todo lo que tenga más de cinco minutos. El id del evento se mantiene igual en los reintentos, así que puedes ignorar los repetidos.

// PHP
$body = file_get_contents('php://input');
parse_str(str_replace(',', '&', $_SERVER['HTTP_X_WEESIFY_SIGNATURE']), $sig);
$expected = hash_hmac('sha256', $sig['t'].'.'.$body, getenv('WEESIFY_WEBHOOK_SECRET'));
if (abs(time() - (int) $sig['t']) > 300 || ! hash_equals($expected, $sig['v1'] ?? '')) {
    http_response_code(400); exit;
}

Evento	Cuándo
contact.created	Nuevo contacto
contact.updated	Datos de contacto modificados
contact.subscribed	Suscrito
contact.unsubscribed	Dado de baja
contact.tagged	Etiqueta añadida
contact.untagged	Etiqueta eliminada
contact.stage_changed	Etapa cambiada
form.submitted	Formulario respondido
order.paid	Pedido pagado
order.refunded	Pedido reembolsado
booking.created	Nueva reserva
booking.cancelled	Reserva cancelada
course.enrolled	Estudiante inscrito
course.completed	Curso completado
community.joined	Se unió a una comunidad
event.created	Evento creado
event.published	Evento publicado
event.updated	Detalles del evento cambiados
event.cancelled	Evento cancelado
event.postponed	Evento aplazado
event.completed	Evento completado
registration.created	Inscripción iniciada
registration.confirmed	Inscripción confirmada
registration.cancelled	Inscripción cancelada
ticket.purchased	Entrada comprada
payment.completed	Pago de entrada completado
payment.failed	Falló el pago de la entrada
ticket.refunded	Entrada reembolsada
attendee.checked_in	Asistente registrado en la entrada
session.attended	Sesión asistida
waitlist.joined	Se unió a una lista de espera
feedback.submitted	Comentarios enviados
post.published	Post published
post.failed	Post failed to publish
site.deployed	Website published
site.deploy_failed	Website failed to publish

Espacio de trabajo 1 endpoint

GET/workspaceThe workspace this token belongs to, and the token’s scopes

The workspace this token belongs to, and the token’s scopes.

curl -X GET https://weesify.com/api/v1/workspace \
  -H "Authorization: Bearer wsy_…"

Enlaces 6 endpoints

GET/linksList short links, newest first

List short links, newest first. Alcance: links:read.

Consulta
search	Matches the back-half, destination or title
status	active (default), archived or all

curl -X GET https://weesify.com/api/v1/links \
  -H "Authorization: Bearer wsy_…"

POST/linksCreate a short link

Create a short link. Alcance: links:write.

Cuerpo
destination_url *	Where it goes (https)
alias	The back-half; random if empty
title	Only you see it
domain_id	One of your domains; weesify.com if empty
redirect_status	301, 302, 307 or 308
starts_at	ISO 8601
ends_at	ISO 8601
click_limit	Integer
utm	{source, medium, campaign, term, content}
forward_query	Boolean

curl -X POST https://weesify.com/api/v1/links \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"destination_url":"\u2026"}'

GET/links/{id}One short link

One short link. Alcance: links:read.

curl -X GET https://weesify.com/api/v1/links/01j… \
  -H "Authorization: Bearer wsy_…"

PATCH/links/{id}Change a short link (send only what changes); archived: true archives it

Change a short link (send only what changes); archived: true archives it. Alcance: links:write.

Cuerpo
destination_url
alias
title
archived	Boolean

curl -X PATCH https://weesify.com/api/v1/links/01j… \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"destination_url":"\u2026"}'

DELETE/links/{id}Delete a short link (its address can be claimed again)

Delete a short link (its address can be claimed again). Alcance: links:write.

curl -X DELETE https://weesify.com/api/v1/links/01j… \
  -H "Authorization: Bearer wsy_…"

GET/links/{id}/statsClicks per day, top countries and referrers

Clicks per day, top countries and referrers. Alcance: links:read + analytics:read.

Consulta
days	7-90 (30)

curl -X GET https://weesify.com/api/v1/links/01j…/stats \
  -H "Authorization: Bearer wsy_…"

Códigos QR 5 endpoints

GET/qr-codesList QR codes

List QR codes. Alcance: qr:read.

Consulta
campaign	Only this campaign

curl -X GET https://weesify.com/api/v1/qr-codes \
  -H "Authorization: Bearer wsy_…"

POST/qr-codesCreate a QR code

Create a QR code. Alcance: qr:write.

Cuerpo
name *
type	dynamic (default), url, text, email, phone, sms, wifi, vcard…
target	{type: short_link\|site, id} for dynamic codes
payload	Content for static types, e.g. {url}
campaign
placement	Where it’s printed

curl -X POST https://weesify.com/api/v1/qr-codes \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"\u2026"}'

GET/qr-codes/{id}One QR code, with SVG and PNG download links

One QR code, with SVG and PNG download links. Alcance: qr:read.

curl -X GET https://weesify.com/api/v1/qr-codes/01j… \
  -H "Authorization: Bearer wsy_…"

PATCH/qr-codes/{id}Change a QR code

Change a QR code. Alcance: qr:write.

Cuerpo
name
target
campaign
placement

curl -X PATCH https://weesify.com/api/v1/qr-codes/01j… \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"\u2026"}'

DELETE/qr-codes/{id}Delete a QR code

Delete a QR code. Alcance: qr:write.

curl -X DELETE https://weesify.com/api/v1/qr-codes/01j… \
  -H "Authorization: Bearer wsy_…"

Contactos 8 endpoints

GET/contactsList contacts

List contacts. Alcance: contacts:read.

Consulta
email	Exact address
tag	A tag id
updated_since	ISO 8601

curl -X GET https://weesify.com/api/v1/contacts \
  -H "Authorization: Bearer wsy_…"

POST/contactsAdd a contact

Add a contact. Alcance: contacts:write.

Cuerpo
email *
name
phone
company
stage	subscriber, lead, customer, student, member
subscribed	true only with the person’s consent (it is recorded)
tags	Tag names
fields	Custom fields by key

curl -X POST https://weesify.com/api/v1/contacts \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"email":"\u2026"}'

GET/contacts/{id}One contact

One contact. Alcance: contacts:read.

curl -X GET https://weesify.com/api/v1/contacts/01j… \
  -H "Authorization: Bearer wsy_…"

PATCH/contacts/{id}Change a contact; subscribed: false unsubscribes

Change a contact; subscribed: false unsubscribes. Alcance: contacts:write.

Cuerpo
email
name
stage
subscribed	false only
tags
fields

curl -X PATCH https://weesify.com/api/v1/contacts/01j… \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"email":"\u2026"}'

DELETE/contacts/{id}Delete a contact and their history

Delete a contact and their history. Alcance: contacts:write.

curl -X DELETE https://weesify.com/api/v1/contacts/01j… \
  -H "Authorization: Bearer wsy_…"

POST/contacts/{id}/tagsTag a contact

Tag a contact. Alcance: contacts:write.

Cuerpo
tag *	A tag name (made if new)

curl -X POST https://weesify.com/api/v1/contacts/01j…/tags \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"tag":"\u2026"}'

DELETE/contacts/{id}/tags/{tag}Remove a tag

Remove a tag. Alcance: contacts:write.

curl -X DELETE https://weesify.com/api/v1/contacts/01j…/tags/01j… \
  -H "Authorization: Bearer wsy_…"

GET/tagsList tags

List tags. Alcance: contacts:read.

curl -X GET https://weesify.com/api/v1/tags \
  -H "Authorization: Bearer wsy_…"

Formularios 3 endpoints

GET/formsList forms

List forms. Alcance: forms:read.

curl -X GET https://weesify.com/api/v1/forms \
  -H "Authorization: Bearer wsy_…"

GET/forms/{id}One form

One form. Alcance: forms:read.

curl -X GET https://weesify.com/api/v1/forms/01j… \
  -H "Authorization: Bearer wsy_…"

GET/forms/{id}/submissionsWhat people submitted

What people submitted. Alcance: forms:read.

Consulta
since	ISO 8601

curl -X GET https://weesify.com/api/v1/forms/01j…/submissions \
  -H "Authorization: Bearer wsy_…"

Tienda 4 endpoints

GET/productsList products

List products. Alcance: store:read.

curl -X GET https://weesify.com/api/v1/products \
  -H "Authorization: Bearer wsy_…"

GET/products/{id}One product

One product. Alcance: store:read.

curl -X GET https://weesify.com/api/v1/products/01j… \
  -H "Authorization: Bearer wsy_…"

GET/ordersList orders, newest first

List orders, newest first. Alcance: store:read.

Consulta
status	paid, pending, failed, refunded, cancelled
since	ISO 8601

curl -X GET https://weesify.com/api/v1/orders \
  -H "Authorization: Bearer wsy_…"

GET/orders/{id}One order with its items

One order with its items. Alcance: store:read.

curl -X GET https://weesify.com/api/v1/orders/01j… \
  -H "Authorization: Bearer wsy_…"

Páginas bio y sitios 2 endpoints

GET/sitesList bio pages and sites

List bio pages and sites. Alcance: sites:read.

curl -X GET https://weesify.com/api/v1/sites \
  -H "Authorization: Bearer wsy_…"

GET/sites/{id}One bio page or site

One bio page or site. Alcance: sites:read.

curl -X GET https://weesify.com/api/v1/sites/01j… \
  -H "Authorization: Bearer wsy_…"

Eventos 23 endpoints

GET/eventsList events, newest first

List events, newest first. Alcance: events:read.

Consulta
status	draft, published, registration_open, …
starts_after	ISO 8601
q	Name contains

curl -X GET https://weesify.com/api/v1/events \
  -H "Authorization: Bearer wsy_…"

POST/eventsCreate an event (a draft) with its first date and tickets

Create an event (a draft) with its first date and tickets. Alcance: events:write.

Cuerpo
name *
timezone *	IANA zone, e.g. Europe/London
starts_local *	Wall clock in the zone: 2026-11-14T18:30
ends_local *	Wall clock in the zone
format	in_person, virtual or hybrid
visibility	public, unlisted, private
registration_mode	open, approval, rsvp, invite, external, none
capacity	Integer
currency	ISO 4217
type	An event type key
venue_id	One of your venues
recurrence	{rule: RRULE}
tickets	[{name, kind, price_minor, quantity}]

curl -X POST https://weesify.com/api/v1/events \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"\u2026","timezone":"\u2026","starts_local":"\u2026","ends_local":"\u2026"}'

GET/events/{id}One event

One event. Alcance: events:read.

curl -X GET https://weesify.com/api/v1/events/01j… \
  -H "Authorization: Bearer wsy_…"

PATCH/events/{id}Change an event (send only what changes)

Change an event (send only what changes). Alcance: events:write.

Cuerpo
name
summary
starts_local
ends_local
timezone
capacity
visibility
venue_id

curl -X PATCH https://weesify.com/api/v1/events/01j… \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"\u2026"}'

POST/events/{id}/statusMove an event through its lifecycle (publish, open registration, cancel…) with the app’s rules

Move an event through its lifecycle (publish, open registration, cancel…) with the app’s rules. Alcance: events:write.

Cuerpo
status *	published, registration_open, registration_closed, postponed, cancelled, …
reason	For cancellations

curl -X POST https://weesify.com/api/v1/events/01j…/status \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"status":"\u2026"}'

GET/events/{id}/occurrencesIts dates, with places left

Its dates, with places left. Alcance: events:read.

Consulta
upcoming	1 = only dates that haven’t ended

curl -X GET https://weesify.com/api/v1/events/01j…/occurrences \
  -H "Authorization: Bearer wsy_…"

GET/events/{id}/ticket-typesIts ticket types and prices (minor units)

Its ticket types and prices (minor units). Alcance: events:read.

curl -X GET https://weesify.com/api/v1/events/01j…/ticket-types \
  -H "Authorization: Bearer wsy_…"

GET/events/{id}/registrationsRegistrations (buyers), newest first

Registrations (buyers), newest first. Alcance: events:attendees.

Consulta
status	confirmed, pending, cancelled, refunded…
email	Exact address

curl -X GET https://weesify.com/api/v1/events/01j…/registrations \
  -H "Authorization: Bearer wsy_…"

POST/events/{id}/registrationsRegister someone (same rules as the event page; paid → pay_url)

Register someone (same rules as the event page; paid → pay_url). Alcance: events:attendees + events:write.

Cuerpo
tickets *	{ticket_type_id: quantity}
email *
name
occurrence_id	For multi-date events
attendees	[{name, email}] one per ticket
code	Promo or access code
answers	Registration form answers by key

curl -X POST https://weesify.com/api/v1/events/01j…/registrations \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"tickets":"\u2026","email":"\u2026"}'

GET/events/{id}/registrations/{item}One registration

One registration. Alcance: events:attendees.

curl -X GET https://weesify.com/api/v1/events/01j…/registrations/01j… \
  -H "Authorization: Bearer wsy_…"

GET/events/{id}/attendeesAttendees (one per ticket) with their ticket number

Attendees (one per ticket) with their ticket number. Alcance: events:attendees.

Consulta
status	confirmed, pending, cancelled…
occurrence_id
checked_in	1

curl -X GET https://weesify.com/api/v1/events/01j…/attendees \
  -H "Authorization: Bearer wsy_…"

GET/events/{id}/attendees/{item}One attendee

One attendee. Alcance: events:attendees.

curl -X GET https://weesify.com/api/v1/events/01j…/attendees/01j… \
  -H "Authorization: Bearer wsy_…"

GET/events/{id}/ticketsTickets: number and status (never the QR payload)

Tickets: number and status (never the QR payload). Alcance: events:attendees.

Consulta
status	valid or void
number	WSY-XXXX-XXXX

curl -X GET https://weesify.com/api/v1/events/01j…/tickets \
  -H "Authorization: Bearer wsy_…"

GET/events/{id}/ordersTicket orders (commerce orders for this event)

Ticket orders (commerce orders for this event). Alcance: events:attendees (+ events.finance role).

Consulta
status	paid, pending, failed, refunded

curl -X GET https://weesify.com/api/v1/events/01j…/orders \
  -H "Authorization: Bearer wsy_…"

GET/events/{id}/sessionsAgenda sessions

Agenda sessions. Alcance: events:read.

curl -X GET https://weesify.com/api/v1/events/01j…/sessions \
  -H "Authorization: Bearer wsy_…"

GET/events/{id}/speakersSpeakers (public profile fields)

Speakers (public profile fields). Alcance: events:read.

curl -X GET https://weesify.com/api/v1/events/01j…/speakers \
  -H "Authorization: Bearer wsy_…"

GET/events/{id}/sponsorsSponsors

Sponsors. Alcance: events:read.

curl -X GET https://weesify.com/api/v1/events/01j…/sponsors \
  -H "Authorization: Bearer wsy_…"

GET/events/{id}/exhibitorsExhibitors

Exhibitors. Alcance: events:read.

curl -X GET https://weesify.com/api/v1/events/01j…/exhibitors \
  -H "Authorization: Bearer wsy_…"

GET/events/{id}/check-insCheck-in scans, with their result

Check-in scans, with their result. Alcance: events:checkin.

Consulta
result	accepted, duplicate, invalid…

curl -X GET https://weesify.com/api/v1/events/01j…/check-ins \
  -H "Authorization: Bearer wsy_…"

POST/events/{id}/check-insScan a ticket (verifies the signed QR; idempotent per client_uuid)

Scan a ticket (verifies the signed QR; idempotent per client_uuid). Alcance: events:checkin.

Cuerpo
payload *	The QR text, WT1.…
client_uuid	UUID from your device
direction	in or out
session_id

curl -X POST https://weesify.com/api/v1/events/01j…/check-ins \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"payload":"\u2026"}'

GET/events/{id}/check-ins/{item}One check-in

One check-in. Alcance: events:checkin.

curl -X GET https://weesify.com/api/v1/events/01j…/check-ins/01j… \
  -H "Authorization: Bearer wsy_…"

GET/venuesYour venues

Your venues. Alcance: events:read.

curl -X GET https://weesify.com/api/v1/venues \
  -H "Authorization: Bearer wsy_…"

GET/venues/{id}One venue

One venue. Alcance: events:read.

curl -X GET https://weesify.com/api/v1/venues/01j… \
  -H "Authorization: Bearer wsy_…"

Bookings & meetings 3 endpoints

GET/booking-servicesBookable services, with length, capacity and price (minor units)

Bookable services, with length, capacity and price (minor units). Alcance: bookings:read.

curl -X GET https://weesify.com/api/v1/booking-services \
  -H "Authorization: Bearer wsy_…"

GET/bookingsBookings, newest first (never the guest’s private meeting link)

Bookings, newest first (never the guest’s private meeting link). Alcance: bookings:read.

Consulta
status	held, pending, confirmed, in_progress, cancelled, attended, no_show
service_id	One service
starts_after	ISO 8601
starts_before	ISO 8601

curl -X GET https://weesify.com/api/v1/bookings \
  -H "Authorization: Bearer wsy_…"

GET/bookings/{id}One booking

One booking. Alcance: bookings:read.

curl -X GET https://weesify.com/api/v1/bookings/01j… \
  -H "Authorization: Bearer wsy_…"

Cursos 4 endpoints

GET/coursesCourses, with lesson and student counts

Courses, with lesson and student counts. Alcance: courses:read.

curl -X GET https://weesify.com/api/v1/courses \
  -H "Authorization: Bearer wsy_…"

GET/courses/{id}One course

One course. Alcance: courses:read.

curl -X GET https://weesify.com/api/v1/courses/01j… \
  -H "Authorization: Bearer wsy_…"

GET/courses/{id}/enrollmentsIts students, with progress (never their private course link)

Its students, with progress (never their private course link). Alcance: courses:read.

Consulta
status	active or revoked
completed	1 = only students who finished

curl -X GET https://weesify.com/api/v1/courses/01j…/enrollments \
  -H "Authorization: Bearer wsy_…"

GET/enrollments/{id}One enrolment

One enrolment. Alcance: courses:read.

curl -X GET https://weesify.com/api/v1/enrollments/01j… \
  -H "Authorization: Bearer wsy_…"

Sitios web 20 endpoints

GET/websitesList HTML websites, newest first

List HTML websites, newest first. Alcance: sites:read.

Consulta
status	draft, published, unpublished, archived or suspended

curl -X GET https://weesify.com/api/v1/websites \
  -H "Authorization: Bearer wsy_…"

POST/websitesCreate an empty HTML website

Create an empty HTML website. Alcance: sites:write.

Cuerpo
name *	Up to 120 characters
slug	Its address: weesify.com/{slug}/ ([a-z0-9-], 3–63). Shared with pages and short links, so it must be free; from the name if empty

curl -X POST https://weesify.com/api/v1/websites \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"\u2026"}'

GET/websites/{id}One website: status, url (https://weesify.com/{slug}/), files and storage

One website: status, url (https://weesify.com/{slug}/), files and storage. Alcance: sites:read.

curl -X GET https://weesify.com/api/v1/websites/01j… \
  -H "Authorization: Bearer wsy_…"

PATCH/websites/{id}Rename it, change its address or homepage, or its routing settings

Rename it, change its address or homepage, or its routing settings. Alcance: sites:write.

Cuerpo
name
slug	New weesify.com/{slug}/ address; the old one redirects
homepage	A path such as index.html
settings	{clean_urls, trailing_slash, spa_fallback, not_found, redirects, headers, noindex}

curl -X PATCH https://weesify.com/api/v1/websites/01j… \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"\u2026"}'

DELETE/websites/{id}Delete a website (disconnects its domains); needs sites:write and the publish permission

Delete a website (disconnects its domains); needs sites:write and the publish permission. Alcance: sites:write.

curl -X DELETE https://weesify.com/api/v1/websites/01j… \
  -H "Authorization: Bearer wsy_…"

GET/websites/{id}/filesEvery file in the working draft (or the live site, or one deployment): path, size, sha256, type

Every file in the working draft (or the live site, or one deployment): path, size, sha256, type. Alcance: sites:read.

Consulta
source	draft (default), live or a deployment id

curl -X GET https://weesify.com/api/v1/websites/01j…/files \
  -H "Authorization: Bearer wsy_…"

POST/websites/{id}/filesUpload files (multipart files[] with optional paths[] and dir); blocked types are reported, not stored

Upload files (multipart files[] with optional paths[] and dir); blocked types are reported, not stored. Alcance: sites:write.

Cuerpo
files *	multipart files[]
paths	multipart paths[]: each file’s relative path
dir	Folder to upload into

curl -X POST https://weesify.com/api/v1/websites/01j…/files \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"files":"\u2026"}'

PUT/websites/{id}/files/{path}Write one file from the raw request body (creates folders as needed)

Write one file from the raw request body (creates folders as needed). Alcance: sites:write.

curl -X PUT https://weesify.com/api/v1/websites/01j…/files/{path} \
  -H "Authorization: Bearer wsy_…"

DELETE/websites/{id}/files/{path}Delete a file or folder from the draft

Delete a file or folder from the draft. Alcance: sites:write.

curl -X DELETE https://weesify.com/api/v1/websites/01j…/files/{path} \
  -H "Authorization: Bearer wsy_…"

POST/websites/{id}/deploymentsPublish the draft — or send a ZIP as multipart archive to replace the draft and publish it. Needs an approved review when the site requires approval

Publish the draft — or send a ZIP as multipart archive to replace the draft and publish it. Needs an approved review when the site requires approval. Alcance: sites:deploy.

Cuerpo
message	Shown in the deployment history
archive	multipart ZIP (also needs sites:write)
replace	With archive: 1 makes the draft exactly the ZIP (files not in it are removed)

curl -X POST https://weesify.com/api/v1/websites/01j…/deployments \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"message":"\u2026"}'

GET/websites/{id}/deploymentsDeployment history, newest first

Deployment history, newest first. Alcance: sites:read.

curl -X GET https://weesify.com/api/v1/websites/01j…/deployments \
  -H "Authorization: Bearer wsy_…"

GET/websites/{id}/deployments/{item}One deployment and its status (live, failed, superseded)

One deployment and its status (live, failed, superseded). Alcance: sites:read.

curl -X GET https://weesify.com/api/v1/websites/01j…/deployments/01j… \
  -H "Authorization: Bearer wsy_…"

POST/websites/{id}/rollbackMake an earlier deployment live again

Make an earlier deployment live again. Alcance: sites:deploy.

Cuerpo
deployment_id *	A deployment of this website

curl -X POST https://weesify.com/api/v1/websites/01j…/rollback \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"deployment_id":"\u2026"}'

GET/websites/{id}/domainsCustom domains: state, DNS records to add, HTTPS

Custom domains: state, DNS records to add, HTTPS. Alcance: sites:read.

curl -X GET https://weesify.com/api/v1/websites/01j…/domains \
  -H "Authorization: Bearer wsy_…"

POST/websites/{id}/domainsConnect a custom domain (pending until its TXT record verifies)

Connect a custom domain (pending until its TXT record verifies). Alcance: sites:write.

Cuerpo
host *	e.g. www.yourbrand.com

curl -X POST https://weesify.com/api/v1/websites/01j…/domains \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"host":"\u2026"}'

POST/websites/{id}/domains/{item}/verifyCheck ownership, DNS and HTTPS now

Check ownership, DNS and HTTPS now. Alcance: sites:write.

curl -X POST https://weesify.com/api/v1/websites/01j…/domains/01j…/verify \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"\u2026"}'

DELETE/websites/{id}/domains/{item}Disconnect a custom domain

Disconnect a custom domain. Alcance: sites:write.

curl -X DELETE https://weesify.com/api/v1/websites/01j…/domains/01j… \
  -H "Authorization: Bearer wsy_…"

POST/websites/{id}/archiveReplace or update the working draft from a ZIP without publishing

Replace or update the working draft from a ZIP without publishing. Alcance: sites:write.

Cuerpo
archive *	multipart ZIP
replace	1: the draft becomes exactly the ZIP; otherwise files are added or overwritten

curl -X POST https://weesify.com/api/v1/websites/01j…/archive \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"archive":"\u2026"}'

GET/websites/{id}/archiveDownload the draft, the live site or one deployment as a ZIP

Download the draft, the live site or one deployment as a ZIP. Alcance: sites:read.

Consulta
source	draft (default), live or a deployment id

curl -X GET https://weesify.com/api/v1/websites/01j…/archive \
  -H "Authorization: Bearer wsy_…"

GET/websites/{id}/usageStorage, bandwidth, views, visits, form submissions and plan limits

Storage, bandwidth, views, visits, form submissions and plan limits. Alcance: sites:read.

curl -X GET https://weesify.com/api/v1/websites/01j…/usage \
  -H "Authorization: Bearer wsy_…"

Blog 3 endpoints

GET/blog/postsBlog posts, newest first (drafts included)

Blog posts, newest first (drafts included). Alcance: blog:read.

Consulta
status	draft, scheduled, published, archived
category_id	One category

curl -X GET https://weesify.com/api/v1/blog/posts \
  -H "Authorization: Bearer wsy_…"

GET/blog/posts/{id}One post, with its body

One post, with its body. Alcance: blog:read.

curl -X GET https://weesify.com/api/v1/blog/posts/01j… \
  -H "Authorization: Bearer wsy_…"

GET/blog/categoriesBlog categories

Blog categories. Alcance: blog:read.

curl -X GET https://weesify.com/api/v1/blog/categories \
  -H "Authorization: Bearer wsy_…"

Analíticas 1 endpoint

GET/analytics/summaryViews and clicks per day, with top countries, referrers and devices

Views and clicks per day, with top countries, referrers and devices. Alcance: analytics:read.

Consulta
days	1-90 (30)
subject	site, short_link or qr_code
subject_id	One of them

curl -X GET https://weesify.com/api/v1/analytics/summary \
  -H "Authorization: Bearer wsy_…"

Webhooks 10 endpoints

GET/webhook-eventsEvery event an endpoint can ask for

Every event an endpoint can ask for. Alcance: webhooks:read.

curl -X GET https://weesify.com/api/v1/webhook-events \
  -H "Authorization: Bearer wsy_…"

GET/webhooksYour webhook, Slack and Discord endpoints

Your webhook, Slack and Discord endpoints. Alcance: webhooks:read.

curl -X GET https://weesify.com/api/v1/webhooks \
  -H "Authorization: Bearer wsy_…"

POST/webhooksAdd an endpoint; the signing secret is in this answer only

Add an endpoint; the signing secret is in this answer only. Alcance: webhooks:write.

Cuerpo
url *	https address on a host name (port 443)
events *	Event names, e.g. ["order.paid"]
kind	webhook (default), slack or discord
description	Only you see it

curl -X POST https://weesify.com/api/v1/webhooks \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"\u2026","events":"\u2026"}'

GET/webhooks/{id}One endpoint and its health

One endpoint and its health. Alcance: webhooks:read.

curl -X GET https://weesify.com/api/v1/webhooks/01j… \
  -H "Authorization: Bearer wsy_…"

PATCH/webhooks/{id}Change its events or description; active: false pauses it, active: true switches it back on

Change its events or description; active: false pauses it, active: true switches it back on. Alcance: webhooks:write.

Cuerpo
events
description
active	Boolean

curl -X PATCH https://weesify.com/api/v1/webhooks/01j… \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"events":"\u2026"}'

DELETE/webhooks/{id}Remove an endpoint

Remove an endpoint. Alcance: webhooks:write.

curl -X DELETE https://weesify.com/api/v1/webhooks/01j… \
  -H "Authorization: Bearer wsy_…"

POST/webhooks/{id}/testSend a signed “ping” now and get the result

Send a signed “ping” now and get the result. Alcance: webhooks:write.

curl -X POST https://weesify.com/api/v1/webhooks/01j…/test \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"\u2026"}'

POST/webhooks/{id}/rotate-secretA new signing secret; the old one keeps signing alongside it for a day

A new signing secret; the old one keeps signing alongside it for a day. Alcance: webhooks:write.

curl -X POST https://weesify.com/api/v1/webhooks/01j…/rotate-secret \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"\u2026"}'

GET/webhooks/{id}/deliveriesIts delivery log (30 days), newest first

Its delivery log (30 days), newest first. Alcance: webhooks:read.

Consulta
status	pending, sending, delivered, failed, dead

curl -X GET https://weesify.com/api/v1/webhooks/01j…/deliveries \
  -H "Authorization: Bearer wsy_…"

POST/webhooks/{id}/deliveries/{item}/redeliverSend a delivery again (same event id)

Send a delivery again (same event id). Alcance: webhooks:write.

curl -X POST https://weesify.com/api/v1/webhooks/01j…/deliveries/01j…/redeliver \
  -H "Authorization: Bearer wsy_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"\u2026"}'

Añade Weesify a tu pantalla de inicio

La API de Weesify