---
title: "Generate broker API key"
method: POST
path: "/api/broker_submissions/api_keys/generate"
tags: ["BrokerSubmissions"]
---

# Generate broker API key

`POST /api/broker_submissions/api_keys/generate`

Create a new API key for a broker-funder relationship. The broker is identified by email domain. If the funder account or broker-funder relationship doesn't exist, they will be created automatically. Returns an error if an API key already exists for this relationship.

## Request body

- CreateBrokerFunderApiKeySchema
  - `email` string, email, required — Broker email address

## Response `200`

OK

- object
  - `broker_funder_token` string — The generated API key token

## Other responses

- `404` — Broker with the specified email domain does not exist
- `409` — API key already exists for this broker-funder relationship

---

[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)