> ## Documentation Index > Fetch the complete documentation index at: https://razorpay-60c89f9a-mintlify-audit-missing-sections-1778528421.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Create a Stakeholder Account > **POST** `/v2/accounts/:account_id/stakeholders` Use this endpoint to create a stakeholder account. ### Request ````curl: Curl theme={null} curl -X POST 'https://api.razorpay.com/v2/accounts/acc_GLGeLkU2JUeyDZ/stakeholders' \ -u [YOUR_KEY_ID]:[YOUR_SECRET] \ -H "Content-type: application/json" \ -d '{ "name":"Gaurav Kumar", "email": "gaurav.kumar@example.com", "addresses":{ "residential":{ "street":"506, Koramangala 1st block", "city":"Bengaluru", "state":"Karnataka", "postal_code":"560034", "country":"IN" } }, "kyc":{ "pan":"AVOPBXXXXX" }, "notes":{ "random_key":"random_value" } }' ```java: Java RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]"); String accountId = "acc_GLGeLkU2JUeyDZ"; JSONObject StakeRequest = new JSONObject(); StakeRequest.put("email","gaurav.kumar@example.com"); StakeRequest.put("name","Gaurav Kumar"); JSONObject residential = new JSONObject(); residential.put("street","506, Koramangala 1st block"); residential.put("city","Bengaluru"); residential.put("state","Karnataka"); residential.put("postal_code","560034"); residential.put("country","IN"); JSONObject addresses = new JSONObject(); addresses.put("residential",residential); StakeRequest.put("addresses",addresses); JSONObject kyc = new JSONObject(); kyc.put("pan","AVOPBXXXXX"); StakeRequest.put("kyc",kyc); JSONObject notes = new JSONObject(); notes.put("random_key_by_partner","random_value"); StakeRequest.put("notes",notes); Stakeholder stakeholder = instance.stakeholder.create(accountId, StakeRequest); ```python: Python import razorpay client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET")) accountId = "acc_GLGeLkU2JUeyDZ" client.stakeholder.create(accountId, { "name": "Gaurav Kumar", "email": "gaurav.kumar@example.com", "addresses": { "residential": { "street": "506, Koramangala 1st block", "city": "Bengaluru", "state": "Karnataka", "postal_code": "560034", "country": "IN" } }, "kyc": { "pan": "AVOPBXXXXX" }, "notes": { "random_key_by_partner": "random_value" } }) ```php: PHP $api = new Api($key_id, $secret); $accountId = "acc_GLGeLkU2JUeyDZ"; $api->account->fetch("acc_GLGeLkU2JUeyDZ")->stakeholders()->create(array( "name" => "Gaurav Kumar", "email" => "gaurav.kumar@example.com", "addresses" => array( "residential" => array( "street" => "506, Koramangala 1st block", "city" => "Bengaluru", "state" => "Karnataka", "postal_code" => "560034", "country" => "IN" ) ), "kyc" => array( "pan" => "AVOPBXXXXX" ), "notes" => array( "random_key_by_partner" => "random_value" ) )); ```csharp: .NET RazorpayClient client = new RazorpayClient(your_key_id, your_secret); string accountId = "acc_GLGeLkU2JUeyDZ"; Dictionary StakeRequest = new Dictionary(); StakeRequest.Add("email", "gaurav.kumar@example.com"); StakeRequest.Add("name", "Gaurav Kumar"); Dictionary residential = new Dictionary(); residential.Add("street", "506, Koramangala 1st block"); residential.Add("city", "Bengaluru"); residential.Add("state", "Karnataka"); residential.Add("postal_code", "560034"); residential.Add("country", "IN"); Dictionary addresses = new Dictionary(); addresses.Add("residential", residential); StakeRequest.Add("addresses", addresses); Dictionary kyc = new Dictionary(); kyc.Add("pan", "AVOPBXXXXX"); StakeRequest.Add("kyc", kyc); Dictionary notes = new Dictionary(); notes.Add("random_key_by_partner", "random_value"); StakeRequest.Add("notes", notes); Stakeholder stakeholder = client.Stakeholder.Create(accountId, StakeRequest); ```ruby: Ruby require "razorpay" Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET') accountId = "acc_GLGeLkU2JUeyDZ" Razorpay::Stakeholder.create(accountId, { "name": "Gaurav Kumar", "email": "gaurav.kumar@example.com", "addresses": { "residential": { "street": "506, Koramangala 1st block", "city": "Bengaluru", "state": "Karnataka", "postal_code": "560034", "country": "IN" } }, "kyc": { "pan": "AVOPBXXXXX" }, "notes": { "random_key_by_partner": "random_value" } }) ```javascript: Node.js var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' }) var accountId = "acc_GLGeLkU2JUeyDZ"; instance.stakeholders.create(accountId, { "name": "Gaurav Kumar", "email": "gaurav.kumar@example.com", "addresses": { "residential": { "street": "506, Koramangala 1st block", "city": "Bengaluru", "state": "Karnataka", "postal_code": "560034", "country": "IN" } }, "kyc": { "pan": "AVOPBXXXXX" }, "notes": { "random_key_by_partner": "random_value" } }); ```go: Go import ( razorpay "github.com/razorpay/razorpay-go" ) client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET") accountId := "acc_GLGeLkU2JUeyDZ" data := map[string]interface{}{ "name": "Gaurav Kumar", "email": "gaurav.kumar@example.com", "addresses": map[string]interface{}{ "residential": map[string]interface{}{ "street": "506, Koramangala 1st block", "city": "Bengaluru", "state": "Karnataka", "postal_code": "560034", "country": "IN", }, }, "kyc": map[string]interface{}{ "pan": "AVOPBXXXXX", }, "notes": map[string]interface{}{ "random_key_by_partner": "random_value", }, } body, err := client.Stakeholder.Create(accountId, data, nil) ```` ### Response ````json: Success theme={null} { "entity":"stakeholder", "relationship":{ "executive":true }, "phone":{ "primary":9000090000, "secondary":999999991 }, "notes":[ ], "kyc":{ "pan":"CZCPG5228F" }, "id":"sth_GLGgm8fFCKc92m", "name":"Gaurav Kumar", "email":"gaurav.kumar@example.com", "percentage_ownership":10, "addresses":{ "residential":{ "street":"506, Koramangala 1st block", "city":"Bengaluru", "state":"Karnataka", "postal_code":"560034", "country":"IN" } } } ```json: Failure { "error":{ "code":"BAD_REQUEST_ERROR", "description":"Linked account does not exist", "source":"", "step":"", "reason":"linked_account_id_does_not_exist", "metadata":{ } } } ```` ### Parameters `account_id` : `string` The unique identifier of the account generated by Razorpay. For example, acc\_GLGeLkU2JUeyDZ. This id is used to fetch or update a stakeholder. ### Parameters `name` : `string` The stakeholder's name as per the PAN card. The maximum length is 255 characters. `email` *mandatory* : `string` The stakeholder's email address. The maximum length is: * local part (before @): 64 characters. * domain part (after @): 68 characters. The total character length supported is 132. `percentage_ownership`*optional* : `float` The stakeholder's ownership of the business in percentage. Only two decimal places are allowed. For example, `87.55`. The maximum length is 100 characters. `relationship` : `object` The stakeholder's relationship with the account's business. `director` : `boolean` Determines if stakeholder is a director of the account's legal entity. * `true`: Stakeholder is a director. * `false` (default): Stakeholder is not a director. `executive` : `boolean` Determines if the stakeholder is an executive of the account's legal entity. * `true`: Stakeholder is an executive. * `false` (false): Stakeholder is not an executive. `phone` *optional* : `object` The stakeholder's phone number. `primary`*optional* : `integer` The primary contact number of the stakeholder. The minimum length is 8 characters and the maximum length is 11. `secondary`*optional* : `integer` The secondary contact number of the stakeholder. The minimum length is 8 characters and the maximum length is 11. `addresses` *optional* : `object` Details of stakeholder's address. `residential` : `object` Details of the stakeholder's residential address. `street` *optional* : `string` The stakeholder's street address. The minimum length is 10 characters and maximum length is 255. `city` *optional* : `string` The city. The minimum length is 2 and maximum length is 32. `state` *optional* : `string` The state. The minimum length is 2 and maximum length is 32. `postal_code` *optional* : `string` The postal code. The minimum length is 2 and maximum length is 10. `country` *optional* : `string` The country. The minimum length is 2 and maximum length is 64. This can either be a country code in capital letters or the full name of the country in lower case letters. For example, for India, you must write either `IN` or `india`. `kyc` *conditional* : `object` The type of document required to establish the stakeholder's identity. `pan` : `string` The PAN number of the stakeholder. * This is a 10-digit alphanumeric code. For example, `AVOPBXXXXX`. * **Regex for Stakeholder PAN**: `/^[a-zA-z]{5}\d{4}[a-zA-Z]{1}$/`. * **Validation for Stakeholder PAN**: The 4th digit should be `P`. `notes` *optional* : `object` Contains user-defined fields stored for reference purposes. Maximum 15 key-value pairs, 512 characters (maximum) each. ### Parameters `id` : `string` The unique identifier of a stakeholder generated by Razorpay, used to fetch or update a stakeholder. For example, `sth_GLGgm8fFCKc92m`. Maximum length supported is 18 characters. `entity` : `string` Here it is `stakeholder`. `percentage_ownership` : `float` The stakeholder's ownership of the business in percentage. Only two decimal places are allowed. For example, `87.55`. The maximum length is 100 characters. `name` : `string` The stakeholder's name as per the PAN card. The maximum length is 255 characters. `email` : `string` The stakeholder's email address. The maximum length is: * local part (before @): 64 characters. * domain part (after @): 68 characters. `relationship` : `object` The stakeholder's relationship with the account's business. `director` : `boolean` Determines if stakeholder is a director of the account's legal entity. * `true`: Stakeholder is a director. * `false` (default): Stakeholder is not a director. `executive` : `boolean` Determines if the stakeholder is an executive of the account's legal entity. * `true`: Stakeholder is an executive. * `false` (false): Stakeholder is not an executive. `phone` : `object` The stakeholder's phone number. `primary` : `integer` The primary contact number of the stakeholder. The minimum length is 8 characters and the maximum length is 11. `secondary` : `integer` The secondary contact number of the stakeholder. The minimum length is 8 characters and the maximum length is 11. `addresses` : `object` Details of stakeholder's address. `residential` : `string` Details of the stakeholder's residential address. `street` : `string` The stakeholder's street address. The minimum length is 10 characters and maximum length is 255. `city` : `string` The city. The minimum length is 2 and maximum length is 32. `state` : `string` The state. The minimum length is 2 and maximum length is 32. `postal_code` : `string` The postal code. The minimum length is 2 and maximum length is 10. `country` : `string` The country. The minimum length is 2 and maximum length is 64. This can either be a country code in capital letters or the full name of the country in lower case letters. For example, for India, you must write either `IN` or `india`. `kyc` : `object` The type of document required to establish the stakeholder's identity. `pan` : `string` The PAN of the stakeholder. * This is a 10-digit alphanumeric code. For example, `AVOPBXXXXX`. * **Regex for Stakeholder PAN**: `/^[a-zA-z]{5}\d{4}[a-zA-Z]{1}$/` * **Validation for Stakeholder PAN**: The 4th digit should be 'P'. **Handy Tip** To complete the KYC process, this API parameter might be required, but it is optional for this API. `notes` : `object` Contains user-defined fields stored by the partner for reference purposes. It can hold a maximum of 15 key-value pairs, 512 characters (maximum) each. For example, "note\_key": "Beam me up Scotty”. ### Errors Linked account does not exist. * code: 400 * description: This error occurs when the requester is not the parent of the child account, or the child account does not exist. * solution: Ensure the Linked Account id exists before proceeding with the update API. Stakeholders cannot be more than one for Route product. * code: 400 * description: This error occurs when you try to create more than one stakeholder for Linked Accounts. * solution: Route products cannot have more than one stakeholder.