Contact Groups

Update contact group

Update the group’s name and/or description. Omitted fields keep their value; the name cannot be empty. The slug does not change.

PATCHhttps://api.sndr.sh/api/cranl/v1/contact-groups/{id}

curl -X PATCH 'https://api.sndr.sh/api/cranl/v1/contact-groups/grp_4d8a0c5e-1f7' \
  -H 'Authorization: Bearer sndr_your_access_token' \
  -H 'Content-Type: application/json' \
  -d '{"name": "Enterprise customers", "description": "Accounts over $10k ARR"}'

200OK

{
  "id":              "grp_4d8a0c5e-1f7",
  "organization_id": "org_8d41c7a2-3f6",
  "name":            "Enterprise customers",
  "slug":            "vip-customers",
  "description":     "Accounts over $10k ARR",
  "member_count":    142,
  "created_at":      "2026-06-01T12:00:00Z"
}

Authorization

Authorizationstringheaderrequired

Bearer followed by an access token. Needs the send scope.

Path parameters

idstringrequired

Group ID (grp_...).

Body

application/json

namestring

New name. Omitting it clears the name.

descriptionstring

New description. Omitting it clears the description.

Errors

401unauthenticatedMissing or invalid Bearer token.

401token_expiredAccess token expired — exchange the refresh token for a new pair.

401token_revokedToken was explicitly revoked.

400invalid_requestBody is not valid JSON, has an unknown field, or a field has the wrong type.

403insufficient_scopeToken is missing the send scope.

404not_foundResource does not exist or belongs to a different account.