---
title: "Create Beneficiary"
method: POST
path: "/beneficiary"
---

# Create Beneficiary

`POST /beneficiary`

Create a new beneficiary for your organization to retire on behalf of.

## Headers

- `x-client-secret` string, required — A secret token identifying the client connecting to the API

## Request body

- union
  - CreateOrganizationBeneficiary
    - `__typename` 'CreateOrganizationBeneficiary' — Contains the name of the model (formally, OpenAPI Schema Object). Used to determine the type of data, for example when two different types are unioned.
    - `beneficiary_name` string, required — A publicly visible name shown on the retirement certificate and registry
    - `beneficiary_domain` string, required — Unique organization domain name for corporate beneficiaries. The domain is not displayed on the registry.
  - CreateIndividualBeneficiary
    - `__typename` 'CreateIndividualBeneficiary' — Contains the name of the model (formally, OpenAPI Schema Object). Used to determine the type of data, for example when two different types are unioned.
    - `beneficiary_name` string, required — A publicly visible name shown on the retirement certificate and registry
    - `beneficiary_email` string, email, required — Unique email address for individual beneficiaries. The email is not displayed on the registry.

## Response `200`

Successful Response

- Organisation
  - `id` string, required
  - `name` string, required
  - `domain` string, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/isometric/apis/isometric-registry-api.md) · [All operations](https://skmtc.net/isometric/apis/isometric-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/isometric/isometric-registry-api/revisions/2e31eeb1cb99/schema)