NOnowadays
Events

Create event

Changed on

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.

post/v1/events

Request

  • Base URL
    https://api.nowadays.ai
  • URL
    https://api.nowadays.ai/v1/events
  • Auth
    API key in header x-api-key

Request body

namestring required

Event title.

formattedLocationsstring[]

Candidate locations. Each entry needs a city.

eventDatesstring[]

Inclusive date ranges, YYYY-MM-DD.

venueTypestring

Venue type. Defaults to 'hotel'.

numPeoplenumber

Total attendees.

numHotelRoomsNeedednumber

Guestrooms needed.

meetingRoomsstring

Free-text meeting-room requirement.

numMeetingRoomsNeedednumber

Meeting rooms needed, counting the general session. Ignored when meetingRoomRequirements is sent, which the count is derived from.

meetingRoomRequirementsobject

The general-session and breakout ask, as the UI stores it.

foodBeverageRequirementsstring

Free-text food and beverage needs.

flexibilitystring

How firm the dates are, in the requester's own words (e.g. 'can shift a week either way').

accommodationsstring[]

Room block per night. One entry per night, each with the room-type split.

currencystring

ISO currency code. Defaults to 'USD'.

organizationIdnumber

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.

Example request

{
  "name": "Annual Summit",
  "formattedLocations": [
    {
      "city": "Austin"
    }
  ],
  "eventDates": [
    {
      "startDate": "2027-03-15",
      "endDate": "2027-03-17"
    }
  ],
  "meetingRoomRequirements": {
    "generalSession": {
      "needed": true,
      "roomCount": 1
    },
    "breakout": {
      "needed": true,
      "count": 3
    }
  },
  "accommodations": [
    {
      "date": "2027-03-15",
      "Single": 60,
      "Double": 11
    }
  ]
}

Response

The created event's id, and how many people can see it

idstring required

Stable public identifier (UUID) of the created event.

grantedTonumber required

How many enterprise memberships were granted visibility. The creator receives owner access separately.

Example response

{
  "id": "3f1a2b4c-5d6e-7f80-9a1b-2c3d4e5f6071",
  "grantedTo": 3
}

Changes

  • f652e8eaffcbRevision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the media type application/json for the response with the status