Skip to main content

API & Webhooks

Last updated: 2026-05-18

Programmatic access to SaaSy is available on the Scale plan ($399/mo or $319/mo annual).

Authentication​

API requests use a bearer token. Generate your token under Settings > API Keys. Tokens are tenant-scoped — they have access to all data in your workspace.

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx

Keep tokens secret. Rotate them from Settings > API Keys if one is compromised.

Base URL​

https://api.hellosaasy.ai

All endpoints are prefixed with /api/v1/.

Interactive reference​

A full OpenAPI/Swagger reference is available at:

https://api.hellosaasy.ai/docs

The reference is interactive — you can authenticate with your API key and make live requests from the browser.

Inbound webhooks from Stripe​

SaaSy accepts Stripe webhook events at:

POST https://api.hellosaasy.ai/api/v1/webhooks/stripe

This endpoint is registered automatically when you connect Stripe via OAuth. For manual setup details, see Integrations — Stripe webhook setup.

Outbound webhooks (v2)​

Outbound webhooks — letting SaaSy push alert and health-change events to your own endpoints — are planned for v2. Email support@hellosaasy.ai if this is blocking your use case and we can prioritise it.

Rate limits​

PlanRequests per minute
Scale300

Exceeding the rate limit returns 429 Too Many Requests with a Retry-After header.

Common endpoints​

These are the most frequently used endpoints. See the interactive reference for the full list.

List customers​

GET /api/v1/customers
Authorization: Bearer <token>

Returns a paginated list of customers with their current health score and churn risk level.

Get customer health​

GET /api/v1/customers/{customer_id}/health
Authorization: Bearer <token>

Returns the full health score breakdown across all five dimensions.

Get churn prediction​

GET /api/v1/customers/{customer_id}/churn-prediction
Authorization: Bearer <token>

Returns the latest churn probability, risk level, risk factors, and recommended interventions.

List alerts​

GET /api/v1/alerts?status=open&severity=high
Authorization: Bearer <token>

Returns open alerts. Filter by status, severity, alert_type, or customer_id.

SDK support​

Official SDKs are on the roadmap for v2. In the meantime, any HTTP client works with the REST API above. The OpenAPI spec at https://api.hellosaasy.ai/docs can be used to generate a client in any language via tools like openapi-generator or fern.