> For the complete documentation index, see [llms.txt](https://docs.auctionplusapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.auctionplusapp.com/admin-api/auction-events/create-an-auction-event.md).

# Create an auction event

Creates a new auction event.

Add auction items to the event by passing the event's ID as `auctionEventId` when creating an auction item.

```json
{"openapi":"3.1.0","info":{"title":"Auction Plus API Documentation","version":"1.0.0"},"tags":[{"name":"Auction Events","description":"An auction event groups auction items under a shared schedule. Each item starts at the time of the event, and end either at the same time or on a staggered schedule. Each event has a **status** of `scheduled`, `active`, or `completed`.\n\nThe **staggerClose** object describes how listings close. When enabled, listings close in groups of **interval**, with **seconds** between each group."}],"servers":[{"url":"https://api.auctionplusapp.com/v1"}],"security":[{"http":[]}],"components":{"securitySchemes":{"http":{"type":"http","description":"You can retrieve your token by visiting Settings > API and clicking <b>Generate Public Token</b>.","scheme":"bearer"}},"schemas":{"AuctionEventResource":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"auction-events"},"attributes":{"type":"object","properties":{"name":{"type":"string"},"startsAt":{"type":"string","format":"date-time"},"endsAt":{"type":"string","format":"date-time"},"staggeredEndsAt":{"type":["string","null"],"format":"date-time","description":"The close time of the last staggered listing, when it extends past endsAt."},"staggerClose":{"type":"object","properties":{"enabled":{"type":"boolean"},"interval":{"type":"integer"},"seconds":{"type":["integer","null"]}},"required":["enabled","interval","seconds"]},"status":{"type":"string","enum":["scheduled","active","completed"]},"archivedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}}}},"required":["id","type"],"title":"AuctionEventResource"}},"responses":{"AuthenticationException":{"description":"Unauthenticated","content":{"application/vnd.api+json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","description":"The HTTP status code applicable to this problem, expressed as a string."},"code":{"type":"string","description":"An application-specific error code."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"id":{"type":"string","description":"A unique identifier for this particular occurrence of the problem."},"title":{"type":"string","description":"A short, human-readable summary of the problem."},"source":{"type":"object","description":"An object containing references to the source of the error.","properties":{"pointer":{"type":"string"},"parameter":{"type":"string"},"header":{"type":"string"}}},"meta":{"type":"object","description":"A meta object containing additional information about the error."}},"required":["status","code","detail"]}}},"required":["errors"]}}}},"ValidationException":{"description":"Validation error","content":{"application/vnd.api+json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","description":"The HTTP status code applicable to this problem, expressed as a string."},"code":{"type":"string","description":"An application-specific error code."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"id":{"type":"string","description":"A unique identifier for this particular occurrence of the problem."},"title":{"type":"string","description":"A short, human-readable summary of the problem."},"source":{"type":"object","description":"An object containing references to the source of the error.","properties":{"pointer":{"type":"string"},"parameter":{"type":"string"},"header":{"type":"string"}}},"meta":{"type":"object","description":"A meta object containing additional information about the error."}},"required":["status","code","detail"]}}},"required":["errors"]}}}}}},"paths":{"/auction-events":{"post":{"operationId":"createAuctionEvent","description":"Creates a new auction event.\n\nAdd auction items to the event by passing the event's ID as `auctionEventId` when creating an auction item.","summary":"Create an auction event","tags":["Auction Events"],"parameters":[{"name":"fields[auction-events]","in":"query","description":"Available values are `name`, `startsAt`, `endsAt`, `staggeredEndsAt`, `staggerClose`, `status`, `archivedAt`, `createdAt`, `updatedAt`. You can include multiple values by separating them with a comma.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"The name of the auction event.","maxLength":255},"startsAt":{"type":"string","format":"date-time","description":"The date and time the event opens (ISO 8601)."},"endsAt":{"type":"string","format":"date-time","description":"The date and time the event closes (ISO 8601)."},"staggerClose":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether listings close in staggered groups rather than all at once. Defaults to false."},"interval":{"type":["integer","null"],"description":"How many listings close in each stagger group. Required when stagger close is enabled.","minimum":1,"maximum":99},"seconds":{"type":["integer","null"],"description":"Seconds between each stagger group closing. Required when stagger close is enabled.","minimum":10,"maximum":3600}}}},"required":["name","startsAt","endsAt"]}}}},"responses":{"201":{"description":"`AuctionEventResource`","content":{"application/vnd.api+json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AuctionEventResource"}},"required":["data"]}}}},"401":{"$ref":"#/components/responses/AuthenticationException"},"422":{"$ref":"#/components/responses/ValidationException"}}}}}}
```