Skip to main content
POST
Create calendar event

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

content-type
enum<string>
required
Available options:
application/json

Body

application/json
end_date
string<date-time>
required
start_date
string<date-time>
required
title
string
required
Required string length: 3 - 70
allow_public_guest_list
boolean
default:false
description

The event description in Slack message content format.

enable_registration_button
boolean
default:false
external_speakers
string | null
is_unlisted
boolean
default:false
location
string | null
luma_event_id
string | null
publish_to_site
boolean
default:true
triggers_webhooks
boolean
default:false
recap

The event recap in Slack message content format.

webhook_custom_metadata
string | null
show_end_date
boolean
default:true
slug
string | null

The URL slug for the event. If not provided, one will be generated based off the title.

Required string length: 3 - 70
status
enum<string>
default:published

The event status. Events created with "published" status will immediately be published to the specified Slack channel(s) and possibly to the site. Events created with "needs_approval" status will be submitted for admin approval. Events cannot be created with "draft" status from the API.

Available options:
needs_approval,
published
publish_to_slack_channels
string[]

The Slack channel(s) that the event announcements are posted to when published. If empty, no Slack announcements are made.

Maximum array length: 10
hosts

The user(s) featured as a host for the event, which must be one of the following: Slack user IDs, emails, or Tightknit profile IDs

speakers

The user(s) featured as a speaker for the event, which must be one of the following: Slack user IDs, emails, or Tightknit profile IDs

cover_image_file_id
string<uuid>
reminders_config
object[] | null

Response

Calendar event created

success
boolean
required
data
object
required