Update a login

PUT /api/v1/account/{account_uuid}/login/{uuid}

Personal access token & O auth2

Path parameters

account_uuid integer Required
uuid integer Required
account string Required

The uuid of the account which the login belongs to.
login string Required

The uuid of the login to display.

application/json

Body Required

expires_at string

Timestamp of how long this login is valid for temporary access. Can leave blank for no expiration.
primary string

Make this the primary login for this account. Only one primary login per account.
has_write_permission boolean Required

Give this login write access for the account. False to leave as read only.
has_delete_permission string Required

Give this access to delete items. False to prevent logins from deleting resources.
wealth_enabled boolean Required

Set to true this login be able to access wealth on the client portal.
goals_enabled boolean Required

Set to true for this login to be able to access goals on the client portal.
factfind_enabled boolean Required

Set to true for this login to be able to access fact-finds on the client portal.
tasks_enabled boolean Required

Set to true for this login to be able to access tasks on the client portal.
receives_unread_notifications_email boolean

Set to true this login should receive the unread notification digest email

Responses

200 application/json
Hide response attributes Show response attributes 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.
- expires_at string
  
  Timestamp for when the login is set to expire.
- has_write_permission boolean
  
  Denotes if the login has access to modify records.
- has_delete_permission boolean
  
  Denotes if the login has access delete records.
- primary boolean
  
  Denotes if the login is the primary login for the account.
- receives_unread_notifications_email boolean
  
  If the login for the account will receive the unred notification emails
- wealth_enabled boolean
  
  If the login for the account will have access to wealth on the client portal.
- goals_enabled boolean
  
  If the login for the account will have access to goals.
- factfind_enabled boolean
  
  If the login for the account will have access to fact-finds.
- tasks_enabled boolean
  
  If the login for the account will have access to tasks.
- welcome_enabled boolean
  
  If the login for the account will have various welcome branding elements.
- first_name string
  
  First name of the user.
- last_name string
  
  Last name of the user.
- email string
  
  Email of the user.
- account object
  
  The account the login is for.
- firm object
  
  The firm the login is for.
- is_impersonated boolean
  
  Denotes if the login was created by Plannr Support as an impersonation login.

PUT /api/v1/account/{account_uuid}/login/{uuid}

curl \
 --request PUT 'https://api.plannrcrm.com/api/v1/account/account_uuid/login/uuid' \
 --header "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 --header "Content-Type: application/json" \
 --header "Accept: application/json" \
 --data '{"expires_at":"2025-06-23T18:21:22+01:00","primary":true,"has_write_permission":true,"has_delete_permission":"1","wealth_enabled":true,"goals_enabled":true,"factfind_enabled":true,"tasks_enabled":true,"receives_unread_notifications_email":true}'

Request examples

# Headers
Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}
Content-Type: application/json
Accept: application/json

# Payload
{
  "expires_at": "2025-06-23T18:21:22+01:00",
  "primary": true,
  "has_write_permission": true,
  "has_delete_permission": "1",
  "wealth_enabled": true,
  "goals_enabled": true,
  "factfind_enabled": true,
  "tasks_enabled": true,
  "receives_unread_notifications_email": true
}

Response examples (200)

{
  "firm": {
    "tax": 17.5,
    "logo": "https://api.plannrcrm.com/images/plannr.jpg",
    "name": "Codepotato",
    "slug": "codepotato",
    "uuid": "7875cb51-673b-4d01-8901-71fb0283a91e",
    "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-06-20T18:21:22+01:00",
    "updated_at": "2025-06-20T18:21:22+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
  },
  "uuid": "1b868583-496b-444b-8b9b-271691832f8d",
  "email": "gareth@plannrcrm.com",
  "account": {
    "firm": "App\\Http\\Resources\\FirmResource",
    "name": "Gareth Thompson",
    "role": "client",
    "tags": "App\\Http\\Resources\\TagResource",
    "type": "client",
    "uuid": "b0776e26-6b4e-4141-89e4-c8cc2a9b3e18",
    "email": "gareth@codepotato.co.uk",
    "groups": "App\\Http\\Resources\\GroupResource",
    "owners": "App\\Http\\Resources\\AccountResource",
    "last_name": "Thompson",
    "created_at": "2025-06-20T18:21:22+01:00",
    "first_name": "Gareth",
    "updated_at": "2025-06-20T18:21:22+01:00",
    "with_login": true,
    "inactive_at": "2025-06-20",
    "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-06-20T18:21:22+01:00",
    "has_joint_account": true,
    "current_time_entry": "App\\Http\\Resources\\TimeEntryResource",
    "first_contact_date": "2025-06-20T18:21:22+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-06-20T18:21:22+01:00",
    "primary_phone_number": "App\\Http\\Resources\\ContactDetailResource",
    "assigned_administrator": "App\\Http\\Resources\\AccountResource",
    "anniversary_review_date": "2025-06-20T18:21:22+01:00"
  },
  "primary": false,
  "last_name": "Thompson",
  "created_at": "2025-06-20T18:21:22+01:00",
  "expires_at": "2025-09-28T18:21:22+01:00",
  "first_name": "Gareth",
  "updated_at": "2025-06-20T18:21:22+01:00",
  "goals_enabled": true,
  "tasks_enabled": true,
  "wealth_enabled": true,
  "is_impersonated": false,
  "welcome_enabled": true,
  "factfind_enabled": true,
  "has_write_permission": false,
  "has_delete_permission": false,
  "receives_unread_notifications_email": true
}