---
title: "Assign contacts to groups"
method: POST
path: "/accounts/self/contacts/assign-groups"
tags: ["Contacts"]
---

# Assign contacts to groups

`POST /accounts/self/contacts/assign-groups`

Assign multiple contacts to multiple groups. **Important:** This operation overwrites existing group assignments for the specified contacts - it does not append to them. Contacts will be unassigned from any group that's not included in this list (Permitted scopes: **fax:all:edit**)

## Request body

- object
  - `groups` string[] — Array of group names to assign to the contacts. This overwrites existing group assignments - contacts will be unassigned from any group that's not included in this list
  - `contact_ids` string[], required — Array of contact IDs to assign to the specified groups
  - `shared` boolean — If true, operate on shared/corporate contacts and groups. If false, operate on personal contacts and groups

## Response `200`

Groups associated successfully

- object

## Other responses

- `400` — Error object in case there's a problem with given data
- `401` — Error object in case there's a problem with the authorization
- `500` — Error object in case there's a server error

---

[API](https://skmtc.net/fax/apis/fax-plus-rest-api.md) · [All operations](https://skmtc.net/fax/apis/fax-plus-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fax/fax-plus-rest-api/revisions/c1afc85d2c15/schema)