---
title: "Create a new group"
method: POST
path: "/v1/groups"
---

# Create a new group

`POST /v1/groups`

## Headers

- `X-Time-Zone` string
- `X-Metric-Units` boolean
- `X-User-Id` integer

## Request body

- object
  - `name` string, required — Specify the name of the group that you are creating.
  - `parent_id` integer — Specify the ID of the new group's parent group.

## Response `200`

200

- object
  - `group` object
    - `id` integer
    - `name` string
    - `company_id` integer
    - `user` object
      - `id` integer
      - `first_name` string
      - `last_name` string
      - `username` unknown
      - `email` string
      - `driver_company_id` unknown
      - `status` string
      - `role` string

## Other responses

- `400` — 400

---

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