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:

"Assistant",,"Assistant to the manager"

If desired, you can also just provide the required name values:


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.