Plenura (plenura.redbroomsoftware.com)
Wellness and therapy platform — therapist discovery, session booking, AI-assisted client matching and session notes, practice management, and earnings withdrawal.
URL: https://plenura.redbroomsoftware.comStatus: LIVE Tier: T2 (vertical SaaS primitive)
T1 apps are indispensable horizontal primitives. T2 apps are vertical SaaS or single-domain primitives — primitive-like in their domain but not universal dependencies.
What you can integrate
- Appointment lifecycle — receive
appointment.completedwhen a therapy session is marked fulfilled; use for billing, CRM enrichment, or loyalty flows - Cancellation events —
booking.cancelledfires when a client or therapist cancels a scheduled appointment - AI therapist matching —
/api/ai/matchreturns a ranked list of therapists for a client profile using semantic search - Practice management — create practices, invite therapists, and manage team access programmatically
- Subscription lifecycle — Plenura gates features by Camino subscription tier; the full event set is consumed for graceful upgrades, downgrades, and expirations
Authentication
Authorization: Bearer <api_key>
Content-Type: application/jsonUser identity flows through RBS SSO (IdP = CPR at ecosystem.redbroomsoftware.com; see Auth). Per-practice API keys are issued from the Plenura admin console. Consumer-facing booking uses session tokens scoped to the client profile.
Endpoints
Endpoint auto-discovery skipped: no Projects/plenura-web source tree found. Table above is hand-curated.
Events emitted
| Event | Receivers | Description |
|---|---|---|
ai.usage | colectiva | AI token usage report for metering |
appointment.completed | colectiva, camino | A therapy or veterinary appointment has been completed and paid |
booking.cancelled | colectiva | A booking has been cancelled. PD-115 (S178-inverse fingerprint): goodbay added as sender — Colectiva's handleBookingCancelled handler at /api/ecosystem/webhooks/+server.js:960 was wired end-to-end but no goodbay producer fired the event, surfacing as a dormant emitter in the S327 audit. Goodbay emits from /api/bookings/[id]/+server.ts after the cancel batch commits. |
booking.created | colectiva | A new booking was created in a hospitality or pet-care app — Colectiva records it for revenue tracking and occupancy analytics. |
upsell.appointment_capacity | camino | Plenura free-tier therapist has hit or is approaching their monthly booking limit (5/month). Camino surfaces a Plenura Pro upgrade recommendation. |
Events consumed
| Event | Senders | Description |
|---|---|---|
cfdi.cancelled | constanza | A CFDI invoice has been cancelled |
employee.missing_data | constanza | Constanza detected an employee with missing fiscal data (RFC/CURP/etc.) — routed back to the source app that created the employee so the missing fields can be completed. |
invoice.compliance_issue | constanza | Constanza detected an invoice compliance issue (missing/invalid RFC, duplicate, format error) — routed back to the source app for review. |
payment.received | colectiva, constanza | A payment has been processed via Colectiva |
payment.status_changed | colectiva | [auto-derived] payment.status_changed event |
subscription.activated | camino, colectiva | A subscription plan has been activated for a tenant — all apps that gate features behind the subscription tier update their local tier state. |
subscription.cancelled | camino, colectiva | A subscription has been cancelled — all apps that gate features behind the subscription tier update their local tier state to free/cancelled. |
subscription.changed | camino | A subscription plan has been upgraded or downgraded — receiver apps update their tier gates and feature access accordingly. |
subscription.expired | camino | A subscription has expired (end of billing period, no renewal) |
subscription.past_due | camino | A tenant's subscription entered past_due state after a failed renewal — Camino dunning flow pauses feature access without cancelling. Receiver apps mark memberships or subscriptions past_due until payment is received. |
subscription.payment_failed | camino, colectiva | A subscription payment attempt failed — receiver apps surface a payment-failed banner to the tenant operator and may restrict feature access. |
subscription.pending_cancellation | camino | A subscription cancellation was scheduled for the end of the current billing period — receiver apps surface a notice that the subscription will end soon. |
subscription.renewed | camino, colectiva | Una suscripción se renovó para un nuevo periodo. Emisor REAL: colectiva (broadcastSubscriptionRenewed, src/lib/services/ecosystem-webhook.service.js, tras el cobro automático con tarjeta guardada; el cron está PAUSADO desde 2026-09-19): lo manda a la app dueña de la suscripción, a camino (auditoría) y a constanza, con ecosystemOrgId = la org del INQUILINO que PAGA (tenants.ecosystem_org_id). camino sólo lo REENVÍA a la app de origen. Las apps receptoras actualizan el fin del periodo y reanudan funciones. ⚠️ Constanza ACUSA y NO asienta (S900b D14, decisión de Brillo 2026-10-08): la fuente del ingreso de RBS y del gasto del pagador es el CFDI que RBS timbra por el cobro (external/cfdi/stamp → ingesta contable → espejo al receptor), nunca el monto de este evento; deja rastro en suscripcion_pago_no_asentado/{eventId} con motivo: fuente_es_el_cfdi. |
subscription.trial_expiring | camino | A trial subscription is expiring soon — receiver apps surface an upgrade prompt to the tenant operator. |
subscription.trial_started | camino | A trial subscription was started — receiver apps activate trial-tier features for the new tenant. |
Webhook signature
Standard ecosystem HMAC-SHA256 over the raw body with a 5-minute timestamp window. See Webhooks.
OpenAPI
Coming in the OpenAPI generator phase — see /reference/openapi.
SDK
See /sdk/ for @r-bsoftware/ecosystem-sdk helpers.
Gotchas
- Practice isolation uses
plenura_therapist_{id}as the tenant pattern — the tenant key is keyed to the lead therapist, not the practice entity. Queries are always scoped through this key. appointment.completedandbooking.cancelledboth feed into Colectiva for earnings metering. Ensure your adapter handles both events if you are building a billing summary.- AI endpoints (
/api/ai/*) emitai.usageevents that feed into Colectiva for per-token billing. Do not call these in loops without rate-limiting on your side.