Skip to main content
POST
Create an event

Authorizations

Authorization
string
header
required

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

Body

multipart/form-data
title
string
required

The title of the event

Example:

"Tech Conference 2025"

category
string
required

General category of the event

Example:

"Technology"

description
string
required

Detailed description of what the event is about

Example:

"A conference for software engineers and founders"

start_date
number
required

Event start date as Unix Timestamp (Seconds or Milliseconds)

Example:

1735651200000

close_date
number
required

Event end date as Unix Timestamp

Example:

1735665600000

timezone
string
required

The IANA timezone string for the event location

Example:

"America/Sao_Paulo"

entry_minutes_in_advance
number
required

How many minutes before start time attendees can enter

Required range: x >= 5
Example:

10

location
object
required

Physical or virtual location details.

ticket_tiers
object[]
required
is_visible
boolean

Whether to show the event to the public immediately

Example:

false

show_on_tickify
boolean

Whether the event should be displayed on Tickify public site (requires admin approval)

Example:

false

banner_image
file

Banner image file (Upload)

profile_image
file

Profile/Thumbnail image file (Upload)

video_url
string
Example:

"https://www.youtube.com/watch?v=dQw4w9WgXcQ"

organizer_name
string

Overrides the logged-in user profile name for this specific event

Example:

"Tech Community Global"

organizer_bio
string

Overrides the logged-in user profile bio for this specific event

Example:

"We run technical events for modern engineers."

organizer_country
string

ISO 3166-1 alpha-2 country code for Stripe Connect onboarding (e.g., US, GB, CA, AU)

Example:

"US"

verifiers
string[]
organisers
string[]

Response

Event created and submitted for approval

eventId
string
Example:

"evt_techconf2025"

status
string
Example:

"PENDING"

event
object
message
string
Example:

"Event created and submitted for approval"