Support

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 https://app.churchsocial.com/api.

Authorization

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.

Responses

All responses are returned as JSON.

Example request

curl -X "GET" "https://app.churchsocial.com/api/sermons" -H "Authorization: YOUR_API_TOKEN"

Sermons

Get all sermons

  • Method: GET
  • Endpoint: https://app.churchsocial.com/api/sermons?limit=15

Get a specific sermon

  • Method: GET
  • Endpoint: https://app.churchsocial.com/api/sermons/{id}

Events

Get all events for a specific month

  • Method: GET
  • Endpoint: https://app.churchsocial.com/api/events?month=2016-11
  • 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: https://app.churchsocial.com/api/events/upcoming?limit=10
  • Has a default limit of 15 if omitted.

Get a specific event

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