Create a case

POST /api/v1/cases

Personal access token & O auth2

Headers

application/json

Body Required

name string Required

The name of the case
participants array[string]

Account uuids belonging to the firm. Must include at least one client.
assigned_to_uuids array[string]

Array of account UUIDs to assign to the case.
group_uuids array[string]

UUIDs of groups that will be assigned when the case is created.
status string

The uuid of the status chosen for the case
review_at string

The date the case should be reviewed
type string

The uuid of the type chosen for the case
value integer

Expect value the case will generate in pennies
plans array[string]

The uuids of the plans chosen for the case

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.
- name string
  
  Name of the case
- slug string
  
  Slug of the case
- status object
  
  Case status
- type object
  
  Case type
- review_at string
  
  Timestamp of when the case should be reviewed
- assigned_to_uuids array[string]
  
  UUIDs of accounts that will be assigned to the case when it is created.
- group_uuids array[string]
  
  UUIDs of groups that will be assigned when the case is created.
- completed_at string
  
  Timestamp of when the case was completed
- value object
  
  Expected value of this case
- status_position integer
  
  The case status's position on the status list. Starting from 1. Only used if you are formatting cases in a kanban layout.
- participants_count integer
  
  The number of participants on the case
- participants object
  
  Participants on this case (if included)
- task_board_uuid string
  
  UUID of the task board
- plans object
  
  Plans in this case (if included)
- custom_fields array[object]
  
  Any custom fields on the model.

POST /api/v1/cases

curl \
 --request POST 'https://api.plannrcrm.com/api/v1/cases' \
 --header "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 --header "Content-Type: application/json" \
 --header "Accept: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"name":"Patrick's Case","participants":["c8c0c178-2454-44e5-b6cc-078dba42e980","41436e98-2475-42bf-a9b5-d46f9ede449d"],"assigned_to_uuids":["17547e30-053e-4deb-8582-927cb77c94c7","90c279b4-b1a8-46eb-834e-f7a1016dc285"],"group_uuids":["497fb939-ce64-41b8-9342-5947bd3dc1ea","acafc212-868e-4722-a314-66e16f8ce984"],"status":"2170b1e7-4ab0-415e-8e48-72e13785207c","review_at":"2025-06-05T11:39:39+01:00","type":"3c9b9cdf-68c2-4cd3-a20d-0e3302b39eed","value":15099,"plans":["9c1641ae-8f31-46d9-a9af-4e503d6b6dcd","5f54ae30-4ed4-4362-b49e-4a1bc97df197"]}'

Request examples

# Headers
Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}
Content-Type: application/json
Accept: application/json
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "name": "Patrick's Case",
  "participants": [
    "c8c0c178-2454-44e5-b6cc-078dba42e980",
    "41436e98-2475-42bf-a9b5-d46f9ede449d"
  ],
  "assigned_to_uuids": [
    "17547e30-053e-4deb-8582-927cb77c94c7",
    "90c279b4-b1a8-46eb-834e-f7a1016dc285"
  ],
  "group_uuids": [
    "497fb939-ce64-41b8-9342-5947bd3dc1ea",
    "acafc212-868e-4722-a314-66e16f8ce984"
  ],
  "status": "2170b1e7-4ab0-415e-8e48-72e13785207c",
  "review_at": "2025-06-05T11:39:39+01:00",
  "type": "3c9b9cdf-68c2-4cd3-a20d-0e3302b39eed",
  "value": 15099,
  "plans": [
    "9c1641ae-8f31-46d9-a9af-4e503d6b6dcd",
    "5f54ae30-4ed4-4362-b49e-4a1bc97df197"
  ]
}

Response examples (200)

{
  "name": "finance",
  "slug": "finance",
  "type": {
    "name": "Mortgage Plan",
    "uuid": "39edcbfd-64df-49f1-95cc-5b8cbb71e885",
    "created_at": "2025-06-05T11:39:39+01:00",
    "updated_at": "2025-06-05T11:39:39+01:00"
  },
  "uuid": "a2c00508-997d-41ce-b1bf-279dda19e2c8",
  "plans": {
    "name": "Johns ISA",
    "tags": "App\\Http\\Resources\\TagResource",
    "type": "cash_account",
    "uuid": "deed1dae-c408-404f-93f6-e4c461ef7397",
    "wrap": "App\\Http\\Resources\\Plans\\PlanResource",
    "cases": "App\\Http\\Resources\\CasesResource",
    "value": {
      "amount": {
        "example": "4000",
        "description": "Money amount at their lowest denominator (for example: pennies)"
      },
      "currency": {
        "example": "GBP",
        "description": "Currency of the money"
      },
      "formatted": {
        "example": "£40.00",
        "description": "Money amount formatted with currency"
      }
    },
    "claims": "App\\Http\\Resources\\Plans\\ClaimResource",
    "client": "App\\Http\\Resources\\AccountResource",
    "covers": "App\\Http\\Resources\\Plans\\CoverResource",
    "seller": "App\\Http\\Resources\\AccountResource",
    "status": "inactive",
    "accounts": "App\\Http\\Resources\\AccountResource",
    "on_panel": true,
    "provider": "App\\Http\\Resources\\Plans\\ProviderResource",
    "sub_type": "lifetime isa",
    "opened_at": "2025-06-05T11:39:39+01:00",
    "valued_at": "2025-06-05T11:39:39+01:00",
    "created_at": "2025-06-05T11:39:39+01:00",
    "statistics": {
      "recent_growth": 100
    },
    "updated_at": "2025-06-05T11:39:39+01:00",
    "advice_area": "non_investment_insurance",
    "inactive_at": "2025-06-05T11:39:39+01:00",
    "review_date": "2024-06-05",
    "linked_plans": "App\\Http\\Resources\\Plans\\PlanResource",
    "main_account": "App\\Http\\Resources\\Plans\\SubAccountResource",
    "sub_accounts": "App\\Http\\Resources\\Plans\\SubAccountResource",
    "under_advice": true,
    "abstract_type": "asset",
    "custom_fields": "App\\Http\\Resources\\CustomFieldValueResource",
    "is_wrap_child": false,
    "linked_owners": "App\\Http\\Resources\\AccountResource",
    "policy_number": "AVIVA-123",
    "show_on_joint": true,
    "wrap_children": "App\\Http\\Resources\\Plans\\PlanResource",
    "can_be_deleted": "false",
    "total_benefits": {
      "critical_illness": {
        "amount": {
          "example": "15000000",
          "description": "Money amount at their lowest denominator (for example: pennies)"
        },
        "currency": {
          "example": "GBP",
          "description": "Currency of the money"
        },
        "formatted": {
          "example": "£150,000.00",
          "description": "Money amount formatted with currency"
        }
      },
      "family_income_benefit": {
        "amount": {
          "example": "10000000",
          "description": "Money amount at their lowest denominator (for example: pennies)"
        },
        "currency": {
          "example": "GBP",
          "description": "Currency of the money"
        },
        "formatted": {
          "example": "£100,000.00",
          "description": "Money amount formatted with currency"
        }
      }
    },
    "inactive_reason": "claimed",
    "is_group_scheme": false,
    "is_wrap_product": false,
    "latest_valuations": "App\\Http\\Resources\\Plans\\ValuationResource",
    "original_valued_at": "2025-06-04T11:39:39+01:00",
    "proposal_reference": "AB123456",
    "agency_in_your_name": true,
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource",
    "is_sub_group_scheme": false,
    "total_benefit_amount": {
      "amount": {
        "example": "25000000",
        "description": "Money amount at their lowest denominator (for example: pennies)"
      },
      "currency": {
        "example": "GBP",
        "description": "Currency of the money"
      },
      "formatted": {
        "example": "£250,000.00",
        "description": "Money amount formatted with currency"
      }
    },
    "is_group_scheme_member": false,
    "originally_sold_by_firm": true,
    "agency_in_your_name_from": "2024-06-05",
    "contract_enquiry_account": "App\\Http\\Resources\\AccountResource",
    "visible_on_client_portal": true,
    "include_in_client_valuation": true
  },
  "value": {
    "amount": {
      "example": "4000",
      "description": "Money amount at their lowest denominator (for example: pennies)"
    },
    "currency": {
      "example": "GBP",
      "description": "Currency of the money"
    },
    "formatted": {
      "example": "£40.00",
      "description": "Money amount formatted with currency"
    }
  },
  "status": {
    "name": "To Be Reviewed",
    "uuid": "609cdd8b-69fb-44eb-aaa3-36e49196555a",
    "colour": "#23852B",
    "position": 5,
    "created_at": "2025-06-05T11:39:39+01:00",
    "updated_at": "2025-06-05T11:39:39+01:00"
  },
  "review_at": "2025-06-05T11:39:39+01:00",
  "created_at": "2025-06-05T11:39:39+01:00",
  "updated_at": "2025-06-05T11:39:39+01:00",
  "group_uuids": [
    "19fc8b9a-f075-4592-a64d-c020e0ff174f"
  ],
  "completed_at": "2025-06-05T11:39:39+01:00",
  "participants": {
    "firm": "App\\Http\\Resources\\FirmResource",
    "name": "Gareth Thompson",
    "role": "client",
    "tags": "App\\Http\\Resources\\TagResource",
    "type": "client",
    "uuid": "144564cb-c632-4e7f-af4d-6ccf006c46a3",
    "email": "gareth@codepotato.co.uk",
    "groups": "App\\Http\\Resources\\GroupResource",
    "owners": "App\\Http\\Resources\\AccountResource",
    "last_name": "Thompson",
    "created_at": "2025-06-05T11:39:39+01:00",
    "first_name": "Gareth",
    "updated_at": "2025-06-05T11:39:39+01:00",
    "with_login": true,
    "inactive_at": "2025-06-05",
    "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-05T11:39:39+01:00",
    "has_joint_account": true,
    "current_time_entry": "App\\Http\\Resources\\TimeEntryResource",
    "first_contact_date": "2025-06-05T11:39:39+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-05T11:39:39+01:00",
    "primary_phone_number": "App\\Http\\Resources\\ContactDetailResource",
    "assigned_administrator": "App\\Http\\Resources\\AccountResource",
    "anniversary_review_date": "2025-06-05T11:39:39+01:00"
  },
  "custom_fields": [
    {
      "name": "Favourite Drink",
      "type": "string",
      "uuid": "2a8f3a81-ccd4-46ef-a64d-7fd036f101a6",
      "value": "Coffee",
      "help_text": "This is the client's favourite drink.",
      "reference": "favourite_drink",
      "created_at": "2025-06-05T11:39:39+01:00",
      "updated_at": "2025-06-05T11:39:39+01:00",
      "is_required": false,
      "selection_options": [
        "Coffee",
        "Tea",
        "Water"
      ]
    }
  ],
  "status_position": 4,
  "task_board_uuid": "d7c75564-890d-4a49-95fa-a0adf58843f7",
  "assigned_to_uuids": [
    "c892fcfd-4ec9-4107-9397-3cea88086734"
  ],
  "participants_count": 4
}