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

# Create event

> Create an event in the organization the API key belongs to. The key's user becomes the owner, so the event's visibility follows their group memberships.



## OpenAPI

````yaml /openapi.json post /v1/events
openapi: 3.0.0
info:
  title: Nowadays Public API
  description: Public developer API for reading Nowadays data.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.nowadays.ai
security: []
tags: []
paths:
  /v1/events:
    post:
      tags:
        - Events
      summary: Create event
      description: >-
        Create an event in the organization the API key belongs to. The key's
        user becomes the owner, so the event's visibility follows their group
        memberships.
      operationId: PublicEventsController_create
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateEventDto'
      responses:
        '201':
          description: The created event's id, and how many people can see it
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicCreateEventDto'
        '400':
          description: Malformed field
        '401':
          description: Missing or invalid API key
        '429':
          description: Rate limit exceeded
      security:
        - x-api-key: []
components:
  schemas:
    CreateEventDto:
      type: object
      properties:
        name:
          type: string
          description: Event title.
          example: Annual Summit
        formattedLocations:
          description: Candidate locations. Each entry needs a `city`.
          example:
            - city: Austin
          type: array
          items:
            type: string
        eventDates:
          description: Inclusive date ranges, YYYY-MM-DD.
          example:
            - startDate: '2027-03-15'
              endDate: '2027-03-17'
          type: array
          items:
            type: string
        venueType:
          type: string
          description: Venue type. Defaults to 'hotel'.
        numPeople:
          type: number
          description: Total attendees.
        numHotelRoomsNeeded:
          type: number
          description: Guestrooms needed.
        meetingRooms:
          type: string
          description: Free-text meeting-room requirement.
        foodBeverageRequirements:
          type: string
          description: Free-text food and beverage needs.
        flexibility:
          type: string
          description: >-
            How firm the dates are, in the requester's own words (e.g. 'can
            shift a week either way').
        accommodations:
          description: >-
            Room block per night. One entry per night, each with the room-type
            split.
          example:
            - date: '2027-03-15'
              Single: 60
              Double: 11
          type: array
          items:
            type: string
        currency:
          type: string
          description: ISO currency code. Defaults to 'USD'.
        organizationId:
          type: number
          description: >-
            The organization to create the event under; must be one the acting
            user belongs to. Ignored on the developer API, where the key already
            binds an organization.
      required:
        - name
    PublicCreateEventDto:
      type: object
      properties:
        id:
          type: string
          description: Stable public identifier (UUID) of the created event.
          example: 3f1a2b4c-5d6e-7f80-9a1b-2c3d4e5f6071
        grantedTo:
          type: number
          description: >-
            How many memberships were granted visibility. Zero means the event
            exists but nobody can see it yet.
          example: 3
      required:
        - id
        - grantedTo
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````