PUT
/api/v2/shareholder/{uuid}
curl \
--request PUT 'https://api.plannrcrm.com/api/v2/shareholder/6ff8f7f6-1eb3-3525-be4a-3932c805afed' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
--data '{"business_uuid":"44394e7d-f43b-4a1d-978c-5ae91f3f1a0a","full_name":"Jane Doe","role":"Clown","appointed_at":"2022-03-17","address":[{"name":{"type":"string","example":"Work Address","required":false,"description":"Name of the address"},"county":{"type":"string","example":"Hampshire","required":false,"description":"County"},"country":{"type":"string","example":"United Kingdom","required":false,"description":"Country"},"postcode":{"type":"string","example":"PO7 7YH","required":false,"description":"Postcode"},"address_1":{"type":"string","example":"Suite E","required":false,"description":"First line of the address"},"address_2":{"type":"string","example":"5 The Briars","required":false,"description":"Second line of the address"},"address_3":{"type":"string","example":"Waterberry Drive","required":false,"description":"Third line of the address"},"address_4":{"type":"string","example":"The Innovative Centre","required":false,"description":"Fourth line of the address"},"town_city":{"type":"string","example":"Waterlooville","required":false,"description":"Town/City"},"move_in_date":{"type":"string","example":"2024-06-20","required":false,"description":"Move in date"},"moved_in_year":{"type":"integer","example":2022,"required":false,"description":"The year the client moved into this address."},"moved_in_month":{"type":"integer","example":6,"required":false,"description":"The month the client moved into this address."},"moved_out_year":{"type":"integer","example":2024,"required":false,"description":"The year the client moved out of this address."},"moved_out_month":{"type":"integer","example":1,"required":false,"description":"The month the client moved out of this address."},"residential_status":{"type":"string","example":"homeowner","required":false,"description":"The client's residential status when living at the address."},"residential_status_other":{"type":"string","example":"Non-tenant occupier","required":false,"description":"The client's residential status if it is not provided in the residential_status options. Must only be provided if residential_status is other."}}],"percentage":25.5,"shares_owned":100,"voting_rights":"All"}'
Request examples
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}
# Payload
{
"business_uuid": "44394e7d-f43b-4a1d-978c-5ae91f3f1a0a",
"full_name": "Jane Doe",
"role": "Clown",
"appointed_at": "2022-03-17",
"address": [
{
"name": {
"type": "string",
"example": "Work Address",
"required": false,
"description": "Name of the address"
},
"county": {
"type": "string",
"example": "Hampshire",
"required": false,
"description": "County"
},
"country": {
"type": "string",
"example": "United Kingdom",
"required": false,
"description": "Country"
},
"postcode": {
"type": "string",
"example": "PO7 7YH",
"required": false,
"description": "Postcode"
},
"address_1": {
"type": "string",
"example": "Suite E",
"required": false,
"description": "First line of the address"
},
"address_2": {
"type": "string",
"example": "5 The Briars",
"required": false,
"description": "Second line of the address"
},
"address_3": {
"type": "string",
"example": "Waterberry Drive",
"required": false,
"description": "Third line of the address"
},
"address_4": {
"type": "string",
"example": "The Innovative Centre",
"required": false,
"description": "Fourth line of the address"
},
"town_city": {
"type": "string",
"example": "Waterlooville",
"required": false,
"description": "Town/City"
},
"move_in_date": {
"type": "string",
"example": "2024-06-20",
"required": false,
"description": "Move in date"
},
"moved_in_year": {
"type": "integer",
"example": 2022,
"required": false,
"description": "The year the client moved into this address."
},
"moved_in_month": {
"type": "integer",
"example": 6,
"required": false,
"description": "The month the client moved into this address."
},
"moved_out_year": {
"type": "integer",
"example": 2024,
"required": false,
"description": "The year the client moved out of this address."
},
"moved_out_month": {
"type": "integer",
"example": 1,
"required": false,
"description": "The month the client moved out of this address."
},
"residential_status": {
"type": "string",
"example": "homeowner",
"required": false,
"description": "The client's residential status when living at the address."
},
"residential_status_other": {
"type": "string",
"example": "Non-tenant occupier",
"required": false,
"description": "The client's residential status if it is not provided in the residential_status options. Must only be provided if residential_status is other."
}
}
],
"percentage": 25.5,
"shares_owned": 100,
"voting_rights": "All"
}
Response examples (200)
{
"firm": {
"tax": 17.5,
"logo": "https://api.plannrcrm.com/images/plannr.jpg",
"name": "Codepotato",
"slug": "codepotato",
"uuid": "9fa50a2a-5611-4b16-bd18-45e2a327aa11",
"county": "Hampshire",
"billing": {
"invoice_email": "gareth@codepotato.co.uk",
"invoice_county": "Hampshire",
"invoice_country": "United Kingdom",
"invoice_postcode": "PO7 7YH",
"invoice_address_1": "Suite E, 5 The Briars",
"invoice_address_2": "Waterberry Drive",
"invoice_town_city": "Waterlooville"
},
"country": "United Kingdom",
"postcode": "PO7 7YH",
"address_1": "Suite E, 5 The Briars",
"address_2": "Waterberry Drive",
"logo_icon": "https://api.plannrcrm.com/images/plannr-icon.jpg",
"month_end": 25,
"town_city": "Waterlooville",
"created_at": "2025-08-07T13:41:48+01:00",
"updated_at": "2025-08-07T13:41:48+01:00",
"ip_whitelist": [
"192.168.0.1",
"127.0.0.1"
],
"brand_colours": {
"sidebar_text": "#ffffff",
"sidebar_hover": "#0A0A42",
"email_sub_text": "#ffffff",
"sidebar_accent": "#36367E",
"sidebar_active": "#53DBB8",
"email_background": "#0E0E56",
"email_button_text": "#ffffff",
"portal_background": "#f6f6f6",
"portal_brand_title": "#323b4b",
"sidebar_background": "#0E0E56",
"portal_sidebar_icon": "#828994",
"portal_sidebar_text": "#323b4b",
"portal_account_email": "#828994",
"portal_sidebar_title": "#11151d",
"sidebar_title_primary": "#FFC634",
"portal_brand_sub_title": "#828994",
"portal_sidebar_divider": "#e3e5e9",
"email_button_background": "#36367E",
"portal_dashboard_bg_one": "#EF4583",
"portal_dashboard_bg_two": "#FFC634",
"sidebar_title_secondary": "#ffffff",
"sidebar_title_background": "#36367E",
"portal_sidebar_icon_hover": "#828994",
"portal_sidebar_text_hover": "#323b4b",
"portal_sidebar_icon_active": "#828994",
"portal_sidebar_text_active": "#323b4b",
"email_logo_background_panel": "#36367E",
"portal_sidebar_button_hover": "#ffffff",
"portal_sidebar_account_title": "#11151d",
"portal_sidebar_button_active": "#ffffff",
"sidebar_title_secondary_hover": "#ffffff",
"portal_sidebar_button_background": "#f6f6f6"
},
"is_subscribed": true,
"regulatory_text": "Regulatory text",
"addon_subscriptions": "App\\Http\\Resources\\Addons\\AddonSubscriptionResource",
"statement_frequency": "monthly",
"task_board_template": "App\\Http\\Resources\\Board\\BoardResource",
"keep_deleted_files_for": 30,
"welcome_paragraph_html": "<h1>Welcome.</h1>",
"email_welcome_paragraph_html": "Welcome to Plannr!",
"show_fact_find_illustrations": true
},
"role": "Director",
"uuid": "b4a40354-cf7c-416e-b299-36a182a07d24",
"account": {
"firm": "App\\Http\\Resources\\FirmResource",
"name": "Gareth Thompson",
"role": "client",
"tags": "App\\Http\\Resources\\TagResource",
"type": "client",
"uuid": "9df963db-db83-4fd7-9762-cd4505191d32",
"email": "gareth@codepotato.co.uk",
"groups": "App\\Http\\Resources\\GroupResource",
"owners": "App\\Http\\Resources\\AccountResource",
"circles": "App\\Http\\Resources\\CircleResource",
"last_name": "Thompson",
"photo_url": "https://eu.ui-avatars.com/api/?name=gareth+thompson",
"created_at": "2025-08-07T13:41:48+01:00",
"first_name": "Gareth",
"updated_at": "2025-08-07T13:41:48+01:00",
"with_login": true,
"inactive_at": "2025-08-07",
"custom_fields": "App\\Http\\Resources\\CustomFieldValueResource",
"introduced_by": "App\\Http\\Resources\\AccountResource",
"primary_email": "App\\Http\\Resources\\ContactDetailResource",
"can_be_deleted": "false",
"assigned_adviser": "App\\Http\\Resources\\AccountResource",
"next_review_date": "2025-08-07T13:41:48+01:00",
"has_joint_account": true,
"current_time_entry": "App\\Http\\Resources\\TimeEntryResource",
"first_contact_date": "2025-08-07T13:41:48+01:00",
"external_references": "App\\Http\\Resources\\ExternalReferenceResource",
"assigned_paraplanner": "App\\Http\\Resources\\AccountResource",
"joint_account_circle": "App\\Http\\Resources\\CircleResource",
"ownership_percentage": 100,
"previous_review_date": "2025-08-07T13:41:48+01:00",
"primary_phone_number": "App\\Http\\Resources\\ContactDetailResource",
"assigned_administrator": "App\\Http\\Resources\\AccountResource",
"anniversary_review_date": "2025-08-07T13:41:48+01:00"
},
"address": {
"name": "Work Address",
"uuid": "ac4f5a04-772c-47f0-8ad4-f2be32ed05bd",
"county": "Hampshire",
"country": "United Kingdom",
"accounts": "App\\Http\\Resources\\AccountResource",
"postcode": "PO7 7YH",
"address_1": "Suite E, 5 The Briars",
"address_2": "Waterberry Drive",
"address_3": "The Innovative Centre",
"address_4": "Waterlooville",
"town_city": "Waterlooville",
"created_at": "2025-08-07T13:41:48+01:00",
"updated_at": "2025-08-07T13:41:48+01:00",
"move_in_date": "2024-08-07"
},
"full_name": "Connor Richards",
"created_at": "2025-08-07T13:41:48+01:00",
"percentage": 42.54,
"updated_at": "2025-08-07T13:41:48+01:00",
"appointed_at": "2015-01-19",
"shares_owned": 60.53,
"voting_rights": "Yes"
}