# Create a shareholder

**POST /api/v2/shareholder**




## Servers
- https://api.plannrcrm.com: https://api.plannrcrm.com ()


## Authentication methods
- Personal access token & O auth2


## Parameters
### Headers
- **X-PLANNR-ACCOUNT-UUID** (string)




### Body: application/json (object)

- **business_uuid** (string(uuid))
  The UUID of the business this shareholder is associated with.
- **full_name** (string)
  The shareholder's full name.
- **ownership_percentage** (float)
  The percentage of ownership this shareholder has, between 0 and 100.
- **shares_owned** (integer)
  The number of shares this shareholder owns.
- **voting_rights** (string)
  The voting rights this shareholder has.
- **role** (string)
  The role of this shareholder.
- **appointed_at** (string(date))
  The date this shareholder was appointed.
- **address** (object)



## Responses
### 201


#### Body: application/json (object)
- **uuid** (string)
  The UUID of the resource.
- **created_at** (string)
  The timestamp of when the resource was created.
- **updated_at** (string)
  The timestamp of when the resource was updated.
- **full_name** (string)
  Full name of the shareholder
- **role** (string)
  Role of the shareholder
- **appointed_at** (string)
  Date the shareholder was appointed
- **address** (object)
  Registered address of the shareholder
- **percentage** (number)
  Percentage of shares owned by the shareholder
- **shares_owned** (number)
  Number of shares owned by the shareholder
- **voting_rights** (string)
  Voting rights of the shareholder
- **firm** (object)
  Firm the shareholder is associated with
- **account** (object)
  Business the shareholder is associated with


[Powered by Bump.sh](https://bump.sh)