---
title: "Add Entity Representative"
method: POST
path: "/entities/{entity_id}/representatives"
tags: ["Entities"]
---

# Add Entity Representative

`POST /entities/{entity_id}/representatives`

## Request

- Base URL: `https://api.meow.com/v1`
- URL: `https://api.meow.com/v1/entities/{entity_id}/representatives`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/meow/apis/meow-api/docs/entities/:entity_id/representatives/post.ts> (a function with typed inputs; its response is checked against the schema)

Add a representative (a beneficial owner or officer) to a business entity. Set `is_primary` to mark the primary representative (signer); exactly one primary is required before the application can be submitted. If this person already passed identity verification on another entity you administer, that verification carries over and `kyc_status` is `approved`. Otherwise verify the representative separately by submitting their KYC data or minting a self-serve verification link. This is allowed only before the application is submitted for review.

## Path parameters

- `entity_id` string, required: The entity being onboarded.

## Request body

- EntityCreateRepresentativeRequest
  - `is_beneficial_owner` boolean: Whether this person owns 25% or more of the business.
  - `percent_ownership` union: Ownership percentage; required when `is_beneficial_owner` is true.
    - number
    - string
  - `email` string, email, required: Email address of the representative.
  - `first_name` string, nullable: Legal first name.
  - `last_name` string, nullable: Legal last name.
  - `title_id` 'chief executive officer' | 'chief financial officer' | 'chief operating officer' | 'finance manager' | 'general partner' | 'managing member' | 'president', required
  - `is_primary` boolean: Whether this representative is the primary representative (signer) for the application. Setting this demotes any existing primary; exactly one primary is required before the application can be submitted.

## Response `201`

Successful Response

- EntityRepresentativeResponse
  - `representative_id` string, uuid, required: ID of the created representative. Use it to submit the representative's KYC or mint a verification link.
  - `email` string, required: Representative's email address.
  - `title_id` 'chief executive officer' | 'chief financial officer' | 'chief operating officer' | 'finance manager' | 'general partner' | 'managing member' | 'president', required
  - `is_beneficial_owner` boolean, required: Whether they are a beneficial owner.
  - `percent_ownership` string, nullable, required: Ownership percentage, if any.
  - `is_primary` boolean, required: Whether they are the primary representative (signer).
  - `kyc_status` 'not_started' | 'pending' | 'action_required' | 'approved' | 'rejected', required

## Other responses

- `400`: The request could not be processed.
- `401`: Authentication failed.
- `403`: The API key is not authorized for this operation.
- `429`: Too many requests.

---

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