---
title: "Allocate the identity + set the inbound webhook callback"
method: POST
path: "/emails/identity"
---

# Allocate the identity + set the inbound webhook callback

`POST /emails/identity`

## Request

- Base URL: `https://worker.openhelm.ai/v1`
- URL: `https://worker.openhelm.ai/v1/emails/identity`
- Auth: HTTP bearer

Allocates the org's address on first call. Set `callback_url` (https) to receive email.received webhooks. Optionally set `username` to choose a friendly address (username@relay.openhelm.ai). Returns the webhook_secret used to HMAC-sign webhooks.

## Request body

- object
  - `callback_url` string, uri: https endpoint for email.received webhooks.
  - `username` string: Friendly email handle, e.g. "pilot-hotel-group" (3–32, a–z/0–9/-, unique).

## Response `200`

OK

---

[API](https://skmtc.dev/openhelm/apis/openhelm-public-api.md) · [All operations](https://skmtc.dev/openhelm/apis/openhelm-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openhelm/apis/openhelm-public-api/revisions/2af88dc2f6a7?raw)