> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnowadays.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Event

> Create a new event in the Nowadays system

This endpoint creates a new event in the Nowadays system. Once created, AI will automatically start adding venues from our database of 400K+ venues to find the ones that fit your criteria. The user that created the event will receive an email with the results within 24 hours.

### Required Fields

<ParamField body="name" type="string" required>
  The name of your event
</ParamField>

<ParamField body="venue_type" type="string" required>
  The type of venue you're looking for
</ParamField>

<ParamField body="event_type" type="string" required>
  The type or category of your event
</ParamField>

<ParamField body="start_date" type="datetime" required>
  Event start date and time (UTC)
</ParamField>

<ParamField body="end_date" type="datetime" required>
  Event end date and time (UTC)
</ParamField>

<ParamField body="location" type="string" required>
  Desired location for the event
</ParamField>

<ParamField body="budget" type="number" required>
  Total budget for the event
</ParamField>

<ParamField body="num_people" type="integer" required>
  Expected number of attendees
</ParamField>

<ParamField body="num_hotel_rooms_needed" type="integer" required>
  Number of hotel rooms required
</ParamField>

<ParamField body="decision_deadline" type="datetime" required>
  Deadline for making the venue decision
</ParamField>

### Contact Information

<ParamField body="email" type="string" required>
  Contact email address
</ParamField>

<ParamField body="first_name" type="string" required>
  Contact first name
</ParamField>

<ParamField body="last_name" type="string" required>
  Contact last name
</ParamField>

<ParamField body="company" type="string" required>
  Company name
</ParamField>

### Optional Fields

<ParamField body="other_notes" type="string">
  Additional requirements or preferences
</ParamField>

<ParamField body="meeting_rooms" type="string">
  Meeting room requirements
</ParamField>

<ParamField body="food_beverage_requirements" type="string">
  Specific food and beverage needs
</ParamField>

<ParamField body="start_time" type="string">
  Start time (for single-day events)
</ParamField>

<ParamField body="end_time" type="string">
  End time (for single-day events)
</ParamField>


## OpenAPI

````yaml POST /events
openapi: 3.0.1
info:
  title: Nowadays API
  description: >-
    API documentation for managing events and venue proposals in the Nowadays
    system
  version: 1.0.0
servers:
  - url: https://nowadays.ai/api/northstar
security:
  - bearerAuth: []
paths:
  /events:
    post:
      summary: Create Event
      description: Creates a new event in the Nowadays system
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EventRequest'
      responses:
        '200':
          description: Event created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  event_id:
                    type: string
                    description: Unique identifier for the created event
components:
  schemas:
    EventRequest:
      type: object
      required:
        - name
        - venue_type
        - event_type
        - start_date
        - end_date
        - location
        - budget
        - num_people
        - num_hotel_rooms_needed
        - decision_deadline
        - email
        - first_name
        - last_name
        - company
      properties:
        name:
          type: string
          description: Name of the event
        venue_type:
          type: string
          description: Type of venue required
        event_type:
          type: string
          description: Type/category of the event
        start_date:
          type: string
          format: date-time
          description: Start date and time in UTC
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````