Skip to main content
POST
Add Entity Representative

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).