---
title: "Create a Stakeholder"
method: POST
path: "/v2/accounts/{account_id}/stakeholders"
tags: ["Linked Accounts", "Partner Stakeholders"]
---

# Create a Stakeholder

`POST /v2/accounts/{account_id}/stakeholders`

Add a business owner or director to a Linked Account. Only one stakeholder is allowed per Route Linked Account. PAN 4th character must be 'P' (individual PAN).

## Path parameters

- `account_id` string, required

## Request body

- object
  - `name` string, required
  - `email` string, required
  - `percentage_ownership` number
  - `relationship` object
    - `director` boolean
    - `executive` boolean
  - `phone` object
  - `addresses` object
  - `kyc` object
    - `pan` string — Individual PAN. 4th character must be P.
  - `notes` Notes — Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.

## Response `200`

Stakeholder created.

- Stakeholder — A business owner or director associated with a Linked Account. Only one stakeholder is allowed per Route Linked Account. Prefix: sth_
  - `id` string — Stakeholder ID. Prefix: sth_
  - `entity` 'stakeholder'
  - `name` string — Full name of the stakeholder.
  - `email` string — Email address.
  - `percentage_ownership` number — Ownership percentage (0-100).
  - `relationship` object
    - `director` boolean — True if the stakeholder is a company director.
    - `executive` boolean — True if the stakeholder is an executive.
  - `phone` object
    - `primary` object
      - `number` string
      - `country_code` string
    - `secondary` object
      - `number` string
      - `country_code` string
  - `addresses` object
    - `residential` object
      - `street` string
      - `city` string
      - `state` string
      - `postal_code` string
      - `country` string
  - `kyc` object
    - `pan` string — Individual PAN. 4th character must be 'P'.
  - `notes` Notes — Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.
  - `created_at` integer

## Other responses

- `400` — Bad request. Invalid parameters or missing required fields.
- `401` — Authentication failed. Invalid or missing API key credentials.
- `429` — Rate limit exceeded. Implement exponential backoff with jitter before retrying.

---

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