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)