Create Hierarchy

post

https://api.authcx.com/Hierarchy

Adds a hierarchy to your organization.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

length ≥ 1

Display name for the new hierarchy node.

category

string | null

Organizational category label.

subCategory

string | null

Organizational subcategory label.

code

string | null

A short internal code for this node used by your organization.

administrativeContactsUserIds

array of strings | null

List of User Id strings to assign as administrative contacts.

administrativeContactsUserIds

escalationContactsUserIds

array of strings | null

List of User Id strings to assign as escalation contacts.

escalationContactsUserIds

managerContactsUserIds

array of strings | null

List of User Id strings to assign as manager contacts.

managerContactsUserIds

hierarchyCodes

array of strings | null

List of string codes from your source system that map to this hierarchy. Used when uploading interactions by code rather than ID.

hierarchyCodes

parentId

uuid | null

Id of an existing hierarchy to nest this node under. Omit to create a top-level node.

Responses

400

One of the following errors occurred: No hierarchy name was provided in the request body, a ParentId was provided but no hierarchy exists with that id
within your organization, a valid ParentId was provided but you don't have enough structure levels for the new hierarchy,
your organization has no structure levels, a user id in the provided contact lists is invalid.

200Returns the newly created Hierarchy, and the name of its parent if applicable