Create Group

post

https://api-{corename}.{env}.gpsrv.com/intserv/4.0/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 Creating a Corporate Hierarchy for instructions on using this endpoint.

Status codes

See Global Response Statuses for status codes that are common across endpoints.

The table below lists status codes that apply to this specific endpoint.

Status code	Description
613-01	Maximum levels exceeded. The root group specifications do not permit this level to be created. Create this group at a higher level in the hierarchy.

Form Data

apiLogin

string

required

Web service username, as provided by Galileo.
Pattern: Max 50 characters
Example: "AbC123-9999"

apiTransKey

string

required

Web service password, as provided by Galileo.
Pattern: Max 15 characters
Example: "4sb62fh6w4h7w34g"

providerId

int32

required

Galileo-issued provider identifier.
Pattern: Max 10 digits
Example: 9999

transactionId

string

required

1 to 60

A unique provider-generated ID to identify this API call. A UUID is preferred.
Pattern: 60 characters or less
Example: "9845dk-39fdk3fj3-4483483478"

groupName

string

required

length between 1 and 40

Name of the group.
Pattern: 1–40 alphanumeric characters, including spaces, hyphens, and single quotes
Example: "CDE Corp"

parentGroupId

string

length between 1 and 10

The identifier of the next group up in the hierarchy. Required when creating a non-root group; not valid when maxLevel is populated. This value cannot be changed after it is set
.Pattern: Max 10 numeric characters
Example: "456"

maxLevel

int32 | null

1 to 5

Maximum number of subgroup levels that can be created below this root group. Required when creating a root group. Not valid when parentGroupId is populated. This value cannot be changed to a smaller number after it is set.
Pattern: Numerals 0–5
Example: 3

externalId

string | null

Provider-specified identifier for the group.
Pattern: Max 30 alphanumeric characters
Example: "L0000"

doingBusinessAs

string | null

Operating name of the company, if different from businessLegalName.
Pattern: 2–150 alphanumeric characters, as shown in businessName parameter
Example: "SportsBall Enterprises"

businessLegalName

string | null

Legal name of the business.
Pattern: 2–150 alphanumeric characters, as shown in businessName parameter
Example: "CDE Corporation, Inc."

phoneCountryCode

string | null

2 to 4

Country code prefix for phone. If this parameter is populated, then phone is required.
Pattern: Plus sign (+) with 1–3 digits
Example: "+011"

phone

string | null

Phone number for the primaryContactName. If this parameter is populated, then phoneCountryCode is required.
Pattern: Phone number for the primaryContactName.
Example: "18015551456"

primaryContactName

string | null

The name of the primary point of contact at businessLegalName.
Pattern: 2–150 Latin-9 characters
Example: "Maxina Seward"

primaryContactEmail

string | null

Email address of primaryContactName.
Pattern: Email address, 3–63 characters
Example: "[email protected]"

smartdata

string | null

enum

Specifies whether the root group is to be enrolled in Mastercard Smart Data.
Pattern: String
Example: "Y"

Allowed:

employerId

string | null

The employer identification number (EIN) from the IRS.
Pattern: 99-9999999.
Example: "12-3456789"

Headers

response-content-type

string

enum

Defaults to json

Use this header instead of the standard accept header to specify the response format.

Allowed:

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Response

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/xml

Status codes

default