---
title: "Create new occurrence"
method: POST
path: "/api/v3/occurrences"
tags: ["Occurrences"]
---

# Create new occurrence

`POST /api/v3/occurrences`

Create a new occurrence (requires authentication)

## Request body

- BaseObjectCreate — Payload for creating Encounters, Individuals, Occurrences, or Annotations
  - `submissionId` string, uuid, required — UUID linking to uploaded files via ResumableUpload
  - `assetFilenames` string[] — List of filenames from the upload session

## Response `200`

Occurrence created successfully

- BaseObjectResponse
  - `success` boolean
  - `statusCode` integer
  - `id` string, uuid — UUID of the created object
  - `class` 'encounters' | 'individuals' | 'occurrences' | 'annotations'
  - `assets` object[]
    - `filename` string
    - `id` integer
    - `uuid` string, uuid
    - `url` string, uri
  - `invalidFiles` object[]
    - `filename` string
  - `locationId` string — For encounters only
  - `submissionDate` string, date-time — For encounters only
  - `errors` object[]
  - `debug` string

## Other responses

- `400` — Invalid request parameters or data
- `401` — Authentication required or invalid session

---

[API](https://skmtc.dev/wildmeorg/apis/wildbook-v3-api.md) · [All operations](https://skmtc.dev/wildmeorg/apis/wildbook-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wildmeorg/wildbook-v3-api/revisions/cae3a14f7bed/schema)