POST
/api/v1/group
curl \
--request POST 'https://api.plannrcrm.com/api/v1/group' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
--data '{"name":"Accounting","participants":["a2100cd0-2ae0-4095-9f3d-e5231aef8a63","8d811eab-799e-4138-81c9-9a15d53413e1"]}'
Request examples
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}
# Payload
{
"name": "Accounting",
"participants": [
"a2100cd0-2ae0-4095-9f3d-e5231aef8a63",
"8d811eab-799e-4138-81c9-9a15d53413e1"
]
}
Response examples (200)
{
"name": "finance",
"slug": "finance",
"uuid": "4202d4e4-159c-4a42-9ba6-9b970b56c166",
"created_at": "2025-10-08T10:40:15+01:00",
"updated_at": "2025-10-08T10:40:15+01:00",
"participants": {
"name": {
"example": "Gareth Thompson",
"description": "Name of the account"
},
"role": {
"example": "client",
"description": "Role of the account"
},
"uuid": {
"example": "b6c7d744-d0d3-424b-967e-702db8ca2661",
"description": "UUID of the account"
},
"email": {
"example": "gareth@codepotato.co.uk",
"description": "Email of the account"
},
"last_name": {
"example": "Thompson",
"description": "Last name of the account"
},
"first_name": {
"example": "Gareth",
"description": "First name of the account"
}
},
"participants_count": "3"
}