API v1 Stable

List contact groups

Lists simple tenant-level contact groups.

POST Stable

List contact groups

/v1/contacts/groups/list

Groups are simple labels/lists, not dynamic CRM segments.

Request

No fields.

curl

curl -X POST 'https://api.emailsdone.dev/v1/contacts/groups/list' \
  -H 'Authorization: Bearer ed_...' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response

Name	Type	Required	Description	Example
`ok`	boolean	Yes	True when groups were read.
`groups`	array	Yes	Contact groups.

{}

Errors

Status	Code	Message
400	`invalid_request`	Request body failed validation.
401	`missing_api_key`	Authorization bearer token is missing.
401	`invalid_api_key`	API key is invalid.
403	`api_key_revoked`	API key has been revoked.
404	`contact_not_found`	Contact was not found.
405	`method_not_allowed`	Only POST is allowed.
500	`internal`	Unexpected server error.

Notes

Contacts are tenant-level recipients for app email history, not CRM records.
Existing environment API keys can access tenant contacts endpoints.