Skip to main content
Create a draft event in the sandbox environment. Draft events are used to collect event details before sending RFPs to venues.

​
Request Body

​
org_id
number
required
Your organization ID
​
name
string
required
Name of the event (e.g., “Annual Conference 2027”)
​
formatted_locations
array
required
Array of location objects containing city, state, country, and coordinates
​
num_people
number
required
Number of attendees expected
​
event_dates
array
required
Array of date objects with date/startDate/endDate and times
​
is_multi_day
boolean
required
Whether the event spans multiple days
​
venue_type
string
Type of venue (e.g., “hotel”, “conference center”, “boutique hotel”)
​
accommodations
object
Room block requirements by date with room types (Single, Double, Suite, etc.)
​
agenda
array
Array of agenda items with room requirements, AV needs, and F&B requirements
​
budget_breakdown
object
Budget allocation for flight, venue, F&B, transport, activities, AV, and other
​
decision_deadline
string
ISO 8601 date for when decision needs to be made
​
custom_questions
array
Array of custom questions to ask venues
​
custom_concessions
array
Array of custom concessions or clauses to request
​
user_email
string
required
Email of the user creating the event
​
user_first_name
string
First name of the user
​
user_last_name
string
Last name of the user

​
Response Format

{
  "draft_event_id": 456,
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "org_id": 123,
  "name": "Annual Conference 2027",
  "num_people": 400,
  "formatted_locations": [
    {
      "city": "Austin",
      "state": "Texas",
      "country": "United States",
      "formatted_address": "Austin, TX, USA",
      "place_id": "ChIJLwPMoJm1RIYRetVp1EtGm10",
      "coordinates": {
        "lat": 30.267153,
        "lng": -97.743057
      }
    }
  ],
  "created_at": "2025-11-21T10:00:00Z",
  "is_multi_day": true,
  "is_northstar_event": false
}

​
Example Request

{
  "org_id": 123,
  "name": "Annual Conference 2027",
  "formatted_locations": [
    {
      "city": "Austin",
      "state": "Texas",
      "country": "United States",
      "formatted_address": "Austin, TX, USA",
      "place_id": "ChIJLwPMoJm1RIYRetVp1EtGm10",
      "coordinates": {
        "lat": 30.267153,
        "lng": -97.743057
      }
    }
  ],
  "num_people": 400,
  "event_dates": [
    {
      "startDate": "2027-03-15",
      "endDate": "2027-03-17"
    }
  ],
  "is_multi_day": true,
  "venue_type": "hotel",
  "user_email": "[email protected]"
}