API v1 Stable

Delete contact group

Deletes a group label and removes it from contacts.

POST Stable

Delete contact group

/v1/contacts/groups/delete

Deleting a group does not delete contacts.

Request

Name	Type	Required	Description	Example
`groupSlug`	string	Yes	Group slug.	`beta-users`

curl

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

Response

Name	Type	Required	Description	Example
`ok`	boolean	Yes	True when group was deleted.

{}

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.