---
title: "Create broker submission"
method: POST
path: "/api/broker_submissions/"
tags: ["BrokerSubmissions"]
---

# Create broker submission

`POST /api/broker_submissions/`

Create a new broker submission with end user details.
**Authentication**: Requires a broker API key in the `x-api-key` header. Generate keys using the `/api/broker_submissions/api_keys/generate` endpoint.

## Request body

- CreateBrokerSubmissionSchema
  - `name` string, required — The name of the submission being made, this is purely for user reference.

## Response `200`

OK

- object
  - `heron_id` string — Heron ID of the created submission

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) · [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/herondata/heron-data-api/revisions/f2e441edece2/schema)