Creates an event

Creates an event with its first event session. The event session inherits the title from the event unless session_title is provided. Session titles are capped at 65 characters by default; pass allow_long_title=true to raise the cap to 200 characters (useful when syncing events from external platforms with longer names). The optional automated_communications object controls the on/off state of the event's automated emails and texts (the same switches shown on the dashboard's Automated Communications tab). Omitted settings keep their defaults: day_before_reminder_email and day_of_reminder_text default to on, day_before_reminder_text, ten_min_before_reminder_text, post_event_survey_email, and post_event_survey_text default to off, and rsvp_confirmation_email follows the organization's RSVP confirmation template settings (on for most organizations). Unknown settings or non-boolean values return a 422. The resulting state is reported back in the automation_status object on the created event.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Event data

string
required

Event title

string
enum
required

Type of event

Allowed:
int64
required

Start time as UNIX timestamp

int64
required

End time as UNIX timestamp

string | null

For virtual: meeting URL. For in_person and hybrid: street address for the in-person session

string | null

Meeting URL for the virtual session when event_type is hybrid

string | null

Display name for location (e.g., "City Hall")

int64
required

ID of the scope (Organization or Chapter)

string
enum
required

Type of scope

Allowed:
string | null

Title for the first event session (defaults to event title). Maximum 65 characters, or 200 when allow_long_title is true.

boolean | null
Defaults to false

When true, raises the session title cap from 65 to 200 characters (default: false)

tags
array of strings | null

Event tags

tags
integer | null

Maximum capacity for the event session (0 = unlimited)

float | null

Latitude for in_person events (optional, will geocode if not provided)

float | null

Longitude for in_person events (optional, will geocode if not provided)

boolean | null
Defaults to false

When true, bypasses duplicate event detection (default: false)

automated_communications
object | null

On/off switches for the event's automated communications. Omitted settings keep their defaults.

Responses
201

event created

404

scope not found

409

duplicate event detected

422

validation error

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here!