Skip to main content
POST
/
entities
/
{entity_id}
/
representatives
Add Entity Representative
curl --request POST \
  --url https://api.meow.com/v1/entities/{entity_id}/representatives \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "email": "jsmith@example.com",
  "is_beneficial_owner": false,
  "percent_ownership": "50",
  "first_name": "Felix",
  "last_name": "Whiskers",
  "is_primary": false
}
'
{
  "representative_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "email": "<string>",
  "is_beneficial_owner": true,
  "percent_ownership": "<string>",
  "is_primary": true
}

Authorizations

​
x-api-key
string
header
required

Your Meow API key, sent in the x-api-key header for authentication.

Path Parameters

​
entity_id
string
required

Body

application/json
​
email
string<email>
required

Email address of the representative.

Example:

"felix@catnipcoffee.com"

​
title_id
enum<string>
required

The representative's job title.

Available options:
chief executive officer,
chief financial officer,
chief operating officer,
finance manager,
general partner,
managing member,
president
​
is_beneficial_owner
boolean
default:false

Whether this person owns 25% or more of the business.

​
percent_ownership

Ownership percentage; required when is_beneficial_owner is true.

Required range: 25 <= x <= 100
Example:

"50"

​
first_name
string | null

Legal first name.

Example:

"Felix"

​
last_name
string | null

Legal last name.

Example:

"Whiskers"

​
is_primary
boolean
default:false

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

Successful Response

​
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
enum<string>
required

The representative's job title.

Available options:
chief executive officer,
chief financial officer,
chief operating officer,
finance manager,
general partner,
managing member,
president
​
is_beneficial_owner
boolean
required

Whether they are a beneficial owner.

​
percent_ownership
string | null
required

Ownership percentage, if any.

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
is_primary
boolean
required

Whether they are the primary representative (signer).