---
title: "Create a caller identity share link"
method: POST
path: "/v1/branded-calling/share"
tags: ["Branded Calling"]
---

# Create a caller identity share link

`POST /v1/branded-calling/share`

Creates a single-use link (valid 7 days) where the end business fills in
the caller identity itself, with no Zernio login: display name, logo, call
reasons, the authorizer and the three references. What it submits lands
under your team as `requested`, the same review as an API submission, and
`branded_calling.identity.status_updated` fires. Scope the link with
`identityId` (complete an identity that is `requested` or
`changes_requested`), with `enterpriseId` (a new identity for a registered
business), or with neither (the business registers itself and its first
identity). The person opening the link can forward a fresh one to someone
else, which retires theirs.

## Request body

- object
  - `enterpriseId` string — A registered business the identity belongs to.
  - `identityId` string — An identity in review to complete. Not with enterpriseId.

## Response `200`

Share link created.

- object
  - `url` string
  - `expiresAt` string, date-time

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Business or identity not found, or the identity is not in review

## Changes

- **2026-09-30** `16a7b9d5373e` — 1 info
  - removed the `platform` enum value from the `details/budgetScope` response property for the response status `400`
- **2026-09-29** `698a0d89ab62` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/branded-calling/share/post.md)

---

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