---
title: "Create Group"
method: POST
path: "/createGroup"
tags: ["Corporate Hierarchy"]
---

# Create Group

`POST /createGroup`

Use the Create Group endpoint to create a root group or a non-root group. When creating a root group, populate these parameters to create the business profile:
- `businessLegalName`
- `doingBusinessAs`
- `phoneCountryCode`
- `phone`
- `primaryContactEmail`
- `primaryContactName`

When creating a non-root group, you can populate the business-profile parameters as desired. All of the name parameters support the Latin-9 (ISO-8859-15) character set. See <a href="doc:creating-a-corporate-hierarchy" target="_blank">Creating a Corporate Hierarchy</a> for instructions on using this endpoint.

## Response `default`

- object
  - `status_code` integer, nullable, required — The response status code. May return a string for some statuses.
  - `status` string, nullable, required — The condition of a process or response
  - `processing_time` number, float, nullable, required — The time elapsed in processing the transaction
  - `echo` object, nullable, required — A structure that contains transaction ID information
    - `transaction_id` string, nullable, required — An ID that represents an API transaction
    - `provider_timestamp` string, date-time, nullable, required — Store a related timestamp for reporting and troubleshooting purposes
    - `provider_transaction_id` string, nullable, required — Secondary transaction identifier (generated by a provider)
  - `system_timestamp` string, date-time, nullable, required — A system generated timestamp
  - `rtoken` string, nullable, required — A system-generated ID used for tracking
  - `errors` string[] — A list of errors generated while the request was processed
  - `response_data` object, nullable, required — A structure for the response data. It can be empty but usually will contain information.
    - `group_id` string, required — Identifier for the group
    - `group_name` string, required — Name of the group
    - `parent_group_id` string, nullable, required — Identifier for the parent group
    - `max_level` integer, nullable, required — Maximum number of levels allowed below the root group
    - `external_id` string, nullable, required — User-provided ID
    - `doing_business_as` string, nullable, required — Operating name of the business, if different from `business_legal_name`
    - `business_legal_name` string, nullable, required — Legal name of the business
    - `phone` string, nullable, required — Business phone number
    - `primary_contact_name` string, nullable, required — Name of the primary contact
    - `primary_contact_email` string, nullable, required — Email of the primary contact at the business
    - `smartdata` string, nullable, required — Whether the root group supports <a href="doc:business-banking-enhancements#mastercard-smart-data" target="_blank">Mastercard Smart Data</a>.
    - `change_ts` string, nullable, required — Timestamp for the last update to the group.
    - `phone_country_code` string, nullable, required — Country code for the phone numbers.
    - `employer_id` string, nullable — Employer identification number (EIN)

---

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