Use the POST {{baseUrl}}/api/v1/groups/file
request to import a CSV file that lists groups to add. The CSV file can contain name
, displayName
, and description
headings but only the name
heading and values are required. As such, the following data would be properly formed in a CSV file:
"name","displayName","description"
"Marketing","MKTG",
"Manager",,
"Assistant",,"Assistant to the manager"
If desired, you can also just provide the required name
values:
"name"
"Marketing"
"Manager"
"Assistant"
When you make this request, PingCentral automatically calls the validate request to check the file before import. If the validation fails, you will receive a 422 Unprocessable Entity code and none of the groups are added.