---
title: "Create and/or update group profile records"
method: POST
path: "/group"
tags: ["group"]
---

# Create and/or update group profile records

`POST /group`

Creates new organizational groups or updates existing group configurations in bulk. Groups organize users, campaigns, and call flows in a hierarchical structure for permissions and reporting.

## Request body

- OrgUnitPost[]
  - `group_id` integer — Organization unit (group) ID the call/record belongs to. Integer. Used to scope data; see /group/list for available group IDs.
  - `group_ext_id` string — A user defined external identifier for the group. Type: string.
  - `group_name` string, required — Human-readable name of the organization unit/group. String.
  - `group_parent_id` integer — The unique ID for the group that would be a parent to the current group. Type: integer (int32).
  - `top_group_id` integer — The unique ID for the top level group associated with current group. Type: integer (int32).
  - `billing_id` integer — The unique ID for the group that is the billing node. Type: integer (int32).
  - `address` string — Caller's street address. String.
  - `city` string — Caller's city (from caller-ID/location lookup). String.
  - `state` string — Caller's state (from caller-ID/location lookup). String (two-letter US state code).
  - `zip` string — The zip code for the group. Type: string.
  - `phone_number` string — Phone number as a string of digits. Typically 10 digits for US numbers.
  - `group_created` string, date — The date and time when the group was created. Type: string (date).
  - `group_modified` string, date-time — The date and time when the group was last updated. Type: string (date-time).
  - `industry_id` integer — The unique identifier for the industry selected. Type: integer (int32).
  - `industry_name` string — The name of the industry selected. Type: string.

## Response `200`

Created or updated group IDs with sequential order numbers matching submission order

- StandardPostResponse[]
  - `result` string, required — Outcome of the request. String, typically 'success' or 'error'.
  - `data` string, required — Response payload. Shape varies by endpoint.
  - `entry_count` integer, required — The sequential number of the entry in the submitted array. Type: integer (int32).

## Other responses

- `default` — Unexpected error

---

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