Create a risk

POST /api/v2/risks

Personal access token & O auth2

Headers

X-PLANNR-ACCOUNT-UUID string

application/json

Body Required

account_uuid string

The UUID of the accounts who should own the risk. These must only be client accounts.
level integer

The risk level of the clients risk assessment. Number between 1 and 1,000. Cannot be set with level_string
level_string string

The risk level of the client as a string/text. Cannot be set with level.
completed_at date Required

Date of risk assessment completion.
completed_by string Required

Uuid of the employee that completed the risk assessment
risk_assessment_provider string

Name of provider for the risk assessment
time_horizon string

Time horizon: how long the risk assessment will last for the client.

Responses

201 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.
- level integer
  
  The risk level of the clients risk assessment. Cannot be set with level_string
- level_string string
  
  The risk level of the client as a string/text. Cannot be set with level.
- completed_at string
  
  Date of risk assessment completion.
- completed_by object
  
  Account of the employee that completed the risk assessment
  
  Hide completed_by attributes Show completed_by attributes object
  
  uuid string
  
  created_at string
  
  updated_at string
  
  type string
  
  role string
  
  first_name string
  
  last_name string
  
  name string
  
  email string
  
  photo_url string
  
  firm string
  
  primary_phone_number string
  
  primary_email string
  
  current_time_entry string
  
  assigned_adviser string
  
  assigned_administrator string
  
  assigned_paraplanner string
  
  introduced_by string
  
  groups string
  
  tags string
  
  owners string
  
  first_contact_date string
  
  next_review_date string
  
  previous_review_date string
  
  anniversary_review_date string
  
  with_login boolean
  
  has_joint_account boolean
  
  can_be_deleted string
  
  joint_account_circle string
  
  circles string
  
  ownership_percentage integer
  
  inactive_at string
  
  custom_fields string
  
  external_references string
- risk_assessment_provider string
  
  Name of the risk assessment provider.
- time_horizon string
  
  How long the risk assessment will last for the client.
- time_horizon_set_at string
  
  The date the time_horizon was set. Can be used as a reference point against time horizon for users.
- account object
  
  The account who owns the Risk. This may not be included when viewing all risks. Refer to the documentation to include this field.
  
  Hide account attributes Show account attributes object
  
  uuid string
  
  created_at string
  
  updated_at string
  
  type string
  
  role string
  
  first_name string
  
  last_name string
  
  name string
  
  email string
  
  photo_url string
  
  external_references string

POST /api/v2/risks

curl \
 --request POST 'https://api.plannrcrm.com/api/v2/risks' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"account_uuid":"c1dd4f4b-f4cb-4f35-beaa-c69b25c32180","level":52,"level_string":"Moderately Aggressive","completed_at":"2024-08-27T17:31:27+01:00","completed_by":"045ddd9f-b735-4354-bddd-3289f233bb34","risk_assessment_provider":"Defaqto","time_horizon":"For the next 5 years"}'

Request examples

# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "account_uuid": "c1dd4f4b-f4cb-4f35-beaa-c69b25c32180",
  "level": 52,
  "level_string": "Moderately Aggressive",
  "completed_at": "2024-08-27T17:31:27+01:00",
  "completed_by": "045ddd9f-b735-4354-bddd-3289f233bb34",
  "risk_assessment_provider": "Defaqto",
  "time_horizon": "For the next 5 years"
}

Response examples (201)

{
  "uuid": "1d3dd429-4623-43b8-ba53-4214ad2b016c",
  "level": 52,
  "account": {
    "name": "Gareth Thompson",
    "role": "client",
    "type": "client",
    "uuid": "ef8e52c9-50df-48e3-a355-5d5d0cad93a1",
    "email": "gareth@codepotato.co.uk",
    "last_name": "Thompson",
    "photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
    "created_at": "2025-08-27T17:31:27+01:00",
    "first_name": "Gareth",
    "updated_at": "2025-08-27T17:31:27+01:00",
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
  },
  "created_at": "2025-08-27T17:31:27+01:00",
  "updated_at": "2025-08-27T17:31:27+01:00",
  "completed_at": "2024-08-27T17:31:27+01:00",
  "completed_by": {
    "firm": "App\\Http\\Resources\\FirmResource",
    "name": "Gareth Thompson",
    "role": "client",
    "tags": "App\\Http\\Resources\\TagResource",
    "type": "client",
    "uuid": "a63e3f7d-7bf5-42e1-b33e-4e1f0d751ae4",
    "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-27T17:31:27+01:00",
    "first_name": "Gareth",
    "updated_at": "2025-08-27T17:31:27+01:00",
    "with_login": true,
    "inactive_at": "2025-08-27",
    "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-27T17:31:27+01:00",
    "has_joint_account": true,
    "current_time_entry": "App\\Http\\Resources\\TimeEntryResource",
    "first_contact_date": "2025-08-27T17:31:27+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-27T17:31:27+01:00",
    "primary_phone_number": "App\\Http\\Resources\\ContactDetailResource",
    "assigned_administrator": "App\\Http\\Resources\\AccountResource",
    "anniversary_review_date": "2025-08-27T17:31:27+01:00"
  },
  "level_string": "Moderately Aggressive",
  "time_horizon": "For the next 5 years",
  "time_horizon_set_at": "2025-07-27T17:31:27+01:00",
  "risk_assessment_provider": "Defaqto"
}