How to use the Church Social REST API
Church Social has a simple public REST API. This provides access to your church's public events and sermons.
Getting started
- To access the API, you'll need your church's public API key. This can be found in Church Social on the church settings page in the calendar and sermon settings.
- The API key is included directly in the URLs, and not as a header.
- CORS (cross-origin resource sharing) is enabled.
- All responses are returned as JSON.
- The base URL is
https://app.churchsocial.com/public/church/{api_key}.
Endpoints
| Name | URL (GET requests) | Options (query params) |
|---|---|---|
| Sermons | /sermons |
limit (15)
page
author_id
series_id
month (YYYY-MM)
text
search
|
| Sermon | /sermons/{sermon_id} |
|
| Sermon authors | /sermon-authors |
|
| Sermon author | /sermon-authors/{author_id} |
|
| Sermon series | /sermon-series |
|
| Sermon series | /sermon-series/{series_id} |
|
| Sermon dates | /sermon-dates |
|
| Sermon texts | /sermon-texts |
|
| Events | /events |
month (YYYY-MM) |
| Event | /events/{event_id}/{YYYY-MM-DD} |
|
| Upcoming events | /events/upcoming |
limit (15) |