Skip to main content

​
Welcome

The Parable API is the REST API that powers the Parable web application. It covers organizations and members, Planning Center integrations and sync, dashboards, reports, widgets, metrics, engagement scoring, the SQL editor, and chat.
The API is currently used by the Parable app itself and is not yet a supported public integration surface — endpoints and payloads can change without notice. If you’d like to build against it, email michael@getparable.io and we’ll work with you directly.

​
Base URLs

​
Authentication

Requests are authenticated with a bearer token issued by WorkOS AuthKit, the identity provider behind Parable sign-in:
Most endpoints are scoped to an organization and take the organization ID in the path, for example /api/v1/org/{orgId}/reports. Access is enforced by role-based permissions — a token only reaches the organizations and actions its user is entitled to.

​
Conventions

  • All request and response bodies are JSON.
  • Paths are versioned under /api/v1.
  • List endpoints are paginated; check each endpoint for its pagination parameters.
  • Monetary values are integers in cents, matching Planning Center.
  • Timestamps are RFC 3339 in UTC.

​
Looking for Data Access Instead?

If your goal is to query your church’s data rather than drive the application, a direct SQL connection is usually the better path — see Accessing Your Data.

​
Questions

Reach out at michael@getparable.io with feedback on what you’d like to see documented here.