Customer Suport

How to use the Church Social REST API

Church Social has a very simple REST API. This currently gives access to a congregation's public calendar events and sermons which have been marked as public. The API is available at


To authorize simply include the church API token in the Authorization header.

For example: Authorization: YOUR_API_TOKEN

Please contact us at [email protected] for your church's API token.


All responses are returned as JSON.

Example request

curl -X "GET" "" -H "Authorization: YOUR_API_TOKEN"


Get all sermons

  • Method: GET
  • Endpoint:

Get a specific sermon

  • Method: GET
  • Endpoint:{id}


Get all events for a specific month

  • Method: GET
  • Endpoint:
  • The month parameter must be in the YYYY-MM format.
  • The month will default to the current month if omitted.

Get the next upcoming events

  • Method: GET
  • Endpoint:
  • Has a default limit of 15 if omitted.

Get a specific event

  • Method: GET
  • Endpoint:{id}/{YYYY-MM-DD}
  • Must include both an event id and date.
  • The date must be in the YYYY-MM-DD format.