Create an event

POST /partners/events

Create an event

cURL

curl --request POST \
  --url https://api-staging.tickify.io/partners/events \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-partner-key: <api-key>' \
  --form 'title=Tech Conference 2025' \
  --form category=Technology \
  --form 'description=A conference for software engineers and founders' \
  --form start_date=1735651200000 \
  --form close_date=1735665600000 \
  --form timezone=America/Sao_Paulo \
  --form entry_minutes_in_advance=10 \
  --form 'location={
  "address": "123 Tech Avenue, Lagos, Nigeria",
  "lat": 6.5244,
  "lon": 3.3792
}' \
  --form 'ticket_tiers={
  "name": "VIP",
  "price": 150,
  "currency": "<string>",
  "capacity": 100,
  "min_tickets_per_order": 1,
  "max_tickets_per_order": 5,
  "group_booking_enabled": false,
  "group_discount_enabled": false,
  "sale_start": 1783882800000,
  "sale_end": 1784487600000,
  "inclusions": "Free drinks, Front row seating",
  "sold_out": false,
  "group_min_tickets": 10,
  "discount_type": "PERCENTAGE",
  "service_fee_rate": 0.05,
  "discount_value": 15,
  "show_remaining_tickets": true
}' \
  --form is_visible=false \
  --form show_on_tickify=false \
  --form banner_image=@example-file \
  --form profile_image=@example-file \
  --form 'video_url=https://www.youtube.com/watch?v=dQw4w9WgXcQ' \
  --form 'social_links={
  "facebook": "https://facebook.com/eventpage",
  "twitter": "https://twitter.com/eventpage",
  "instagram": "https://instagram.com/eventpage",
  "youtube": "https://youtube.com/eventpage",
  "website": "https://eventwebsite.com"
}' \
  --form 'organizer_name=Tech Community Global' \
  --form 'organizer_bio=We run technical events for modern engineers.' \
  --form organizer_country=US \
  --form 'verifiers=<string>' \
  --form 'organisers=<string>'

201

{
  "eventId": "evt_techconf2025",
  "status": "PENDING",
  "event": {
    "key": "evt_techconf2025",
    "title": "Tech Conference 2025",
    "category": "Technology",
    "description": "A conference for software engineers and founders",
    "start_date": 1735651200000,
    "close_date": 1735665600000,
    "is_visible": true,
    "show_on_tickify": true,
    "timezone": "America/New_York",
    "entry_minutes_in_advance": 15,
    "organizer_name": "John Doe",
    "organizer_bio": "We run technical events for modern engineers.",
    "organizer_country": "US",
    "verifiers": [
      "user1",
      "user2"
    ],
    "organisers": [
      "org1",
      "org2"
    ],
    "ticket_tiers": [
      {
        "name": "General Admission",
        "price": 50,
        "capacity": 100
      }
    ]
  },
  "message": "Event created and submitted for approval"
}

Authorizations

x-partner-key · string · header · required

Partner API Key (tk_live_... or tk_test_...)

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.

Show child attributes

ticket_tiers · object[] · required

Show child attributes

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"

social_links · object

Show child attributes

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

201

application/json

Event created and submitted for approval

eventId · string

Example:

"evt_techconf2025"

status · string

Example:

"PENDING"

event · object

Show child attributes

message · string

Example:

"Event created and submitted for approval"