Events API - Project Zoe

All endpoints require a Bearer token. Results are scoped to the authenticated user’s tenant and hierarchy.

GET /api/events

List events.

Query parameters

Parameter	Type	Description
`groupId`	number	Filter by hosting group
`categoryId`	number	Filter by event category
`from`	date	Start of date range (`YYYY-MM-DD`)
`to`	date	End of date range (`YYYY-MM-DD`)
`page`	number	Page number
`limit`	number	Results per page

Response

{
  "data": [
    {
      "id": 3,
      "name": "Easter Conference 2025",
      "description": "Annual Easter gathering",
      "startDate": "2025-04-18",
      "endDate": "2025-04-20",
      "group": { "id": 10, "name": "Kampala, Uganda" },
      "category": { "id": 2, "name": "Conference" }
    }
  ],
  "total": 14
}

POST /api/events

Create an event.

Request body

{
  "name": "Easter Conference 2025",
  "description": "Annual Easter gathering",
  "startDate": "2025-04-18",
  "endDate": "2025-04-20",
  "groupId": 10,
  "categoryId": 2,
  "metaData": {
    "venue": "Kampala International University",
    "expectedAttendance": 500
  }
}

GET /api/events/:id

Get an event with its registration and attendance records.

PUT /api/events/:id

Update an event.

DELETE /api/events/:id

Delete an event and its associated records.

Event categories

GET /api/events/categories

List all event categories for the tenant.

POST /api/events/categories

{ "name": "Outreach", "description": "Community evangelism events" }

Registration

GET /api/events/:id/registration

Get the registration list for an event.

POST /api/events/:id/registration

{ "contactIds": [42, 43, 44] }

DELETE /api/events/:id/registration/:registrationId

Cancel a registration.

Attendance

GET /api/events/:id/attendance

Get the attendance list for an event.

POST /api/events/:id/attendance

Record attendance for an event:

{ "contactIds": [42, 43] }

Event activities

Event activities record what happened for specific individuals during an event (e.g. a salvation or baptism).

GET /api/events/:id/activities

List activities for an event.

POST /api/events/:id/activities

{
  "activityType": "Salvation",
  "contactIds": [55, 56],
  "notes": "Responded during altar call"
}

​GET /api/events

​Query parameters

​Response

​POST /api/events

​Request body

​GET /api/events/:id

​PUT /api/events/:id

​DELETE /api/events/:id

​Event categories

​GET /api/events/categories

​POST /api/events/categories

​Registration

​GET /api/events/:id/registration

​POST /api/events/:id/registration

​DELETE /api/events/:id/registration/:registrationId

​Attendance

​GET /api/events/:id/attendance

​POST /api/events/:id/attendance

​Event activities

​GET /api/events/:id/activities

​POST /api/events/:id/activities