---
title: "Create group"
method: POST
path: "/v1/account-groups"
tags: ["Account Groups"]
---

# Create group

`POST /v1/account-groups`

Creates a new account group with a name and a list of social account IDs.
Accounts can belong to different profiles; the caller must have access to
every account's profile. Group names must be unique per user.

## Request body

- object
  - `name` string, required
  - `accountIds` string[], required
  - `profileId` string — Deprecated. Accepted for backward compatibility but ignored. Groups are no longer scoped to a single profile.

## Response `201`

Created

- object
  - `message` string
  - `group` object
    - `_id` string
    - `name` string
    - `accountIds` string[]

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `409` — Group name already exists

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/f81ca70ea6b9/schema)