Skip to main content
POST
/
events
curl -X POST "https://api.tktchurch.com/v1/events" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Sunday Worship Service",
    "description": "Weekly Sunday worship service",
    "startDate": "2024-01-07T10:00:00Z",
    "endDate": "2024-01-07T12:00:00Z",
    "timezone": "America/New_York",
    "location": {
      "name": "Main Sanctuary",
      "address": "123 Church Street",
      "city": "New York",
      "state": "NY",
      "country": "USA",
      "postalCode": "10001",
      "coordinates": {
        "latitude": 40.7128,
        "longitude": -74.0060
      }
    },
    "type": "service",
    "recurrence": {
      "frequency": "weekly",
      "interval": 1,
      "byDay": ["SU"]
    },
    "reminders": [
      {
        "type": "email",
        "minutes": 1440
      },
      {
        "type": "notification",
        "minutes": 60
      }
    ],
    "tags": ["worship", "sunday-service"],
    "maxCapacity": 500,
    "requiresGeolocation": true,
    "geofenceRadius": 100
  }'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "Sunday Worship Service",
  "description": "Weekly Sunday worship service",
  "startDate": "2024-01-07T10:00:00Z",
  "endDate": "2024-01-07T12:00:00Z",
  "timezone": "America/New_York",
  "location": {
    "name": "Main Sanctuary",
    "address": "123 Church Street",
    "city": "New York",
    "state": "NY",
    "country": "USA",
    "postalCode": "10001",
    "coordinates": {
      "latitude": 40.7128,
      "longitude": -74.0060
    }
  },
  "type": "service",
  "status": "scheduled",
  "recurrence": {
    "frequency": "weekly",
    "interval": 1,
    "byDay": ["SU"]
  },
  "reminders": [
    {
      "type": "email",
      "minutes": 1440
    },
    {
      "type": "notification",
      "minutes": 60
    }
  ],
  "calendarLinks": {
    "google": "https://calendar.google.com/...",
    "apple": "webcal://...",
    "outlook": "https://outlook.office.com/...",
    "yahoo": "https://calendar.yahoo.com/...",
    "ics": "https://api.tktchurch.com/v1/events/123/calendar.ics"
  },
  "tags": ["worship", "sunday-service"],
  "maxCapacity": 500,
  "requiresGeolocation": true,
  "geofenceRadius": 100,
  "createdByUserId": "456e7890-f12g-34h5-i678-912345678901",
  "updatedByUserId": "456e7890-f12g-34h5-i678-912345678901",
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-01T00:00:00Z"
}
This endpoint requires authentication and the createEvent permission.

​
Request Body

​
title
string
required
Event title
​
description
string
required
Event description
​
startDate
string
required
Event start date and time in ISO 8601 format
​
endDate
string
required
Event end date and time in ISO 8601 format
​
timezone
string
required
Event timezone (e.g., “America/New_York”)
​
location
object
required
Event location details
​
type
string
required
Event type. One of:
  • service: Church service
  • meeting: Meeting
  • concert: Concert
  • workshop: Workshop
  • conference: Conference
  • social: Social event
  • other: Other event type
​
status
string
Event status. One of:
  • scheduled (default): Default status for upcoming events
  • cancelled: Cancelled events
  • postponed: Postponed events
  • rescheduled: Rescheduled events
​
recurrence
object
Event recurrence details
​
reminders
array
Event reminders
​
attachments
array
Event attachments
​
tags
array
Array of event tags
​
maxCapacity
integer
Maximum number of attendees (if applicable)
​
requiresGeolocation
boolean
Whether geolocation is required for attendance
​
geofenceRadius
number
Geofence radius in meters (if applicable)
​
thumbnailId
string
UUID of the uploaded thumbnail file

​
Response

Returns the created event object. See Get Event Details for the response format.

​
Error Responses

​
error
object
Error details when the request fails
Common error cases:
  • 400 Bad Request: Invalid request body or validation errors
  • 401 Unauthorized: Missing or invalid access token
  • 403 Forbidden: Insufficient permissions
curl -X POST "https://api.tktchurch.com/v1/events" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Sunday Worship Service",
    "description": "Weekly Sunday worship service",
    "startDate": "2024-01-07T10:00:00Z",
    "endDate": "2024-01-07T12:00:00Z",
    "timezone": "America/New_York",
    "location": {
      "name": "Main Sanctuary",
      "address": "123 Church Street",
      "city": "New York",
      "state": "NY",
      "country": "USA",
      "postalCode": "10001",
      "coordinates": {
        "latitude": 40.7128,
        "longitude": -74.0060
      }
    },
    "type": "service",
    "recurrence": {
      "frequency": "weekly",
      "interval": 1,
      "byDay": ["SU"]
    },
    "reminders": [
      {
        "type": "email",
        "minutes": 1440
      },
      {
        "type": "notification",
        "minutes": 60
      }
    ],
    "tags": ["worship", "sunday-service"],
    "maxCapacity": 500,
    "requiresGeolocation": true,
    "geofenceRadius": 100
  }'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "Sunday Worship Service",
  "description": "Weekly Sunday worship service",
  "startDate": "2024-01-07T10:00:00Z",
  "endDate": "2024-01-07T12:00:00Z",
  "timezone": "America/New_York",
  "location": {
    "name": "Main Sanctuary",
    "address": "123 Church Street",
    "city": "New York",
    "state": "NY",
    "country": "USA",
    "postalCode": "10001",
    "coordinates": {
      "latitude": 40.7128,
      "longitude": -74.0060
    }
  },
  "type": "service",
  "status": "scheduled",
  "recurrence": {
    "frequency": "weekly",
    "interval": 1,
    "byDay": ["SU"]
  },
  "reminders": [
    {
      "type": "email",
      "minutes": 1440
    },
    {
      "type": "notification",
      "minutes": 60
    }
  ],
  "calendarLinks": {
    "google": "https://calendar.google.com/...",
    "apple": "webcal://...",
    "outlook": "https://outlook.office.com/...",
    "yahoo": "https://calendar.yahoo.com/...",
    "ics": "https://api.tktchurch.com/v1/events/123/calendar.ics"
  },
  "tags": ["worship", "sunday-service"],
  "maxCapacity": 500,
  "requiresGeolocation": true,
  "geofenceRadius": 100,
  "createdByUserId": "456e7890-f12g-34h5-i678-912345678901",
  "updatedByUserId": "456e7890-f12g-34h5-i678-912345678901",
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-01T00:00:00Z"
}