Groups
Count groups
Return the count of the authenticated user's groups. Cheap path for a sidebar badge / quota check without loading the full list.
GET /v2/groups/count
Parameters
Query parameters
where
object
Responses
200 — Successful response
Content-Type: application/json
data
object required
data.count
integer required
Example
{
"data": {
"count": 0
}
}
400 — Request body failed validation.
Content-Type: application/json
(body)
any
401 — Missing or invalid API key.
Content-Type: application/json
(body)
any
403 — Valid key, insufficient permission.
Content-Type: application/json
(body)
any
404 — Resource does not exist.
Content-Type: application/json
(body)
any
409 — Request conflicts with the current state of the resource.
Content-Type: application/json
(body)
any
429 — Rate limit exceeded.
Content-Type: application/json
(body)
any
500 — Unexpected server error.
Content-Type: application/json
(body)
any
Code samples
curl https://api.prod.getdex.com/v2/groups/count \
--header 'Authorization: Bearer YOUR_API_KEY'
fetch('https://api.prod.getdex.com/v2/groups/count', {
headers: {
Authorization: 'Bearer YOUR_API_KEY'
}
})
requests.get(
"https://api.prod.getdex.com/v2/groups/count",
headers={
"Authorization": "Bearer YOUR_API_KEY"
}
)
Create a group
Create ONE group. Accepts `name`, `emoji`, `description`, `parent_id` (for nested groups), and an optional `groups_contacts` array to add starter members. **Requires `Idempotency-Key`.** Returns `{ da
Get contact counts per group
Return the contact count for each group in one round-trip. Pass `?groupIds=a,b,c` to scope the query to specific groups; omit it to fetch counts for every group the user owns. Returns `{ data: { count