# Contact Groups

> Organize contacts into segments for targeted broadcasts.

Source: https://sndr.sh/docs/cranl/contact-groups

Contact groups are lists of contacts. Every broadcast targets one group, and a contact can belong to several groups at once.

- [List contact groups](https://sndr.sh/docs/cranl/contact-groups/list-contact-groups) `GET /api/cranl/v1/contact-groups`: List all contact groups on the connected account, newest first, with member counts.
- [Create contact group](https://sndr.sh/docs/cranl/contact-groups/create-contact-group) `POST /api/cranl/v1/contact-groups`: Create a contact group.
- [Get contact group](https://sndr.sh/docs/cranl/contact-groups/get-contact-group) `GET /api/cranl/v1/contact-groups/{id}`: Retrieve one contact group with its member count.
- [Update contact group](https://sndr.sh/docs/cranl/contact-groups/update-contact-group) `PATCH /api/cranl/v1/contact-groups/{id}`: Update the group’s name and/or description.
- [Delete contact group](https://sndr.sh/docs/cranl/contact-groups/delete-contact-group) `DELETE /api/cranl/v1/contact-groups/{id}`: Delete a group and its memberships.
- [List group members](https://sndr.sh/docs/cranl/contact-groups/list-group-members) `GET /api/cranl/v1/contact-groups/{id}/members`: List the contacts in a group, most recently added first.
- [Add group members](https://sndr.sh/docs/cranl/contact-groups/add-group-members) `POST /api/cranl/v1/contact-groups/{id}/members`: Add contacts to a group by ID.
- [Remove group members](https://sndr.sh/docs/cranl/contact-groups/remove-group-members) `DELETE /api/cranl/v1/contact-groups/{id}/members`: Remove contacts from a group.
