Body
-
The name of the case
-
Account uuids belonging to the firm. Must include at least one client.
-
Array of account UUIDs to assign to the case.
-
UUIDs of groups that will be assigned when the case is created.
-
The uuid of the status chosen for the case
-
The date the case should be reviewed
-
The uuid of the type chosen for the case
-
Expect value the case will generate in pennies
-
The uuids of the plans chosen for the case
POST
/api/v1/cases
curl \
--request POST 'https://api.plannrcrm.com/api/v1/cases' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
--data '{"name":"Patrick's Case","participants":["06570798-2ec0-4c7c-8017-b9851341d210","c2426581-6fc3-45e0-8900-0233ea766fe4","5943e8a9-ebcc-4455-8796-1ab87a917422"],"assigned_to_uuids":["2d43d337-ec4f-427a-ad55-dbc5bfbc2340","ac7ac228-a216-4ef6-a324-6a23fadc5f13","df481110-9b45-436e-bb86-8299baa90acb"],"group_uuids":["8b8dbef3-3885-4abf-ac12-27fbb7b98ffb","ccb102ad-641b-4166-8f3e-8aeda8111c13","31f19df6-d7e4-4be1-9be8-8b2323a56311"],"status":"5cbdf553-9dc1-48a0-8dce-0cb3d79f6fc7","review_at":"2026-03-20T13:25:15+00:00","type":"6d8237fd-60cd-4ccf-a5c3-6afa9c3c4ee8","value":15099,"plans":["e4e25d33-3638-4244-b1bd-48e33ccfb4f4","862a929d-071d-4774-ae49-6d23ed3d4dff","0c074498-b8d2-47f4-bac9-667f8c77fca7"]}'
Request examples
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}
# Payload
{
"name": "Patrick's Case",
"participants": [
"06570798-2ec0-4c7c-8017-b9851341d210",
"c2426581-6fc3-45e0-8900-0233ea766fe4",
"5943e8a9-ebcc-4455-8796-1ab87a917422"
],
"assigned_to_uuids": [
"2d43d337-ec4f-427a-ad55-dbc5bfbc2340",
"ac7ac228-a216-4ef6-a324-6a23fadc5f13",
"df481110-9b45-436e-bb86-8299baa90acb"
],
"group_uuids": [
"8b8dbef3-3885-4abf-ac12-27fbb7b98ffb",
"ccb102ad-641b-4166-8f3e-8aeda8111c13",
"31f19df6-d7e4-4be1-9be8-8b2323a56311"
],
"status": "5cbdf553-9dc1-48a0-8dce-0cb3d79f6fc7",
"review_at": "2026-03-20T13:25:15+00:00",
"type": "6d8237fd-60cd-4ccf-a5c3-6afa9c3c4ee8",
"value": 15099,
"plans": [
"e4e25d33-3638-4244-b1bd-48e33ccfb4f4",
"862a929d-071d-4774-ae49-6d23ed3d4dff",
"0c074498-b8d2-47f4-bac9-667f8c77fca7"
]
}
Response examples (200)
{
"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"
}
}