---
title: "Create Group"
method: POST
path: "/groups"
tags: ["Groups"]
---

# Create Group

`POST /groups`

Create a new group belonging to the provided organization.

## Request body

- object — The details of the group being created.
  - `name` string, required — The name of the group.
  - `description` string — The user provided description of the group.
  - `countryCode` 'US' | 'CA' | 'PR', required — The country code of the country the group is registered in.
  - `location` object, required — The location of the group. This is used to assign a timezone and enforce hours of operation.
    - `label` string, required — The human readable location of the group.
    - `coordinates` object, required — The coordinates that the group location is set to.
      - `lat` number, required — The latitude of the group location.
      - `lng` number, required — The longitude of the group location.
  - `organizationId` string, required — The organization this group belongs to.

## Response `200`

Returns the created group.

- Group — A group belongs to an Organization and organizes leads/agents/goals.
  - `id` string, required — The ID of the group.
  - `type` 'group', required — The type of object the attached ID corresponds to.
  - `name` string, required — The name of the group.
  - `description` string — The user provided description of the group.
  - `countryCode` 'US' | 'CA' | 'PR', required — The country code of the country the group is registered in.
  - `active` boolean, required — Whether or not the group is active.
  - `location` object — The location of the group.
    - `label` string, required — The human readable location of the group.
    - `coordinates` object, required — The coordinates that the group location is set to.
      - `lat` number, required — The latitude of the group location.
      - `lng` number, required — The longitude of the group location.
  - `organizationId` string, required — The organization this group belongs to.
  - `timezone` string, required — The timezone of the group. Represented as an IANA Zone ID.
  - `createdAt` string, required — An ISO-8601 string representing the date the group was created.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

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