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":["2246f0bd-5405-46b0-b958-edb5d0a8beb9","6e621a7f-23b0-4332-8cc7-b99d0e715c2c"]}'
Request examples
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}
# Payload
{
"name": "Accounting",
"participants": [
"2246f0bd-5405-46b0-b958-edb5d0a8beb9",
"6e621a7f-23b0-4332-8cc7-b99d0e715c2c"
]
}
Response examples (200)
{
"name": "finance",
"slug": "finance",
"uuid": "613544b9-674b-4dee-a131-c2b24e4f0cbd",
"created_at": "2025-08-27T17:31:26+01:00",
"updated_at": "2025-08-27T17:31:26+01:00",
"participants": {
"name": {
"example": "Gareth Thompson",
"description": "Name of the account"
},
"role": {
"example": "client",
"description": "Role of the account"
},
"uuid": {
"example": "e55de5fa-8f42-4d03-90c1-e6f024ab2e62",
"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"
}