---
title: "Create a group"
method: POST
path: "/accounts/self/contact-groups"
tags: ["Contacts"]
---

# Create a group

`POST /accounts/self/contact-groups`

Create a new contact group (Permitted scopes: **fax:all:edit**)

## Request body

- ContactGroupCreate
  - `name` string, required — Group name
  - `notes` string — Additional notes or description for the group
  - `shared` boolean — Whether to share group with corporate members

## Response `201`

Response containing a single group object

- ContactGroup
  - `id` string — Group ID
  - `name` string — Group name
  - `notes` string — Additional notes or description for the group
  - `is_shared` boolean — Whether group is shared with corporate members
  - `creation_date` string — Date group was created
  - `modification_date` string — Date group was last modified

## 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)