---
title: "Create a new event"
method: POST
path: "/api/events"
tags: ["Events"]
---

# Create a new event

`POST /api/events`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/events`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/events/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new event with optional multiple events creation for consecutive seasons

## Request body

- object
  - `hometeam_id` integer, required: ID of the home team
  - `awayteam_id` integer: ID of the away team (optional)
  - `name` string, required: Event name
  - `scheduled_date` string, date: Scheduled date
  - `scheduled_time` string, time: Scheduled time
  - `startDate` string, date: Start date for multi-day events
  - `endDate` string, date: End date for multi-day events
  - `venue` integer: Venue ID
  - `event_type` string: Type of event (e.g., social, single, multi, season)
  - `season` integer: Season year
  - `status` 'assigned' | 'inprogress' | 'inreview' | 'rejected' | 'approved': User event status
  - `user_event_type` 'Other' | 'Venue' | 'Property' | 'TV' | 'Radio' | 'Digital' | 'Social' | 'Quick Add' | 'Print' | 'Streaming Audio' | 'Streaming Video' | 'Virtual Venue': User event type (defaults to Other if not specified)
  - `user_id` integer: User ID to assign the event to
  - `captured_by` integer, nullable: Optional. User id recorded once as Captured By on the report created when `status` is sent: who or what actually sourced the data, separate from the bearer-token account and from `user_id`. Must be an existing, non-deleted user. Left null when not sent. Cannot be changed after creation.
  - `eventsCount` integer: Number of events to create for consecutive seasons

## Response `200`

Event(s) created successfully

- object[]

## Other responses

- `401`: Unauthenticated
- `422`: Validation error

---

[API](https://skmtc.dev/sponsorunited/apis/sponsorunited-api.md) - [All operations](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/revisions/cbf1ca5bff8f?raw)