eloomi v3 docs: Create a new department

Request

POST https://api.eloomi.com/v3/units

Query parameters

Parameter name	Value	Description	Additional
unique	string	Should check unique constraint on insert Possible values are: `code`	Optional

Request headers

Parameter name	Value	Description	Additional
ClientId	string	Provided by eloomi	Required
Authorization	string	Look in the documentation for the authentication endpoint on how to construct this	Required

Request body

{
    "access_groups": [
        "integer"
    ],
    "add_department_learning_manager_emails": [
        "string"
    ],
    "add_department_learning_manager_employee_ids": [
        "string"
    ],
    "add_department_learning_manager_ids": [
        "integer"
    ],
    "add_department_organizational_manager_emails": [
        "string"
    ],
    "add_department_organizational_manager_employee_ids": [
        "string"
    ],
    "add_department_organizational_manager_ids": [
        "integer"
    ],
    "add_department_performance_manager_emails": [
        "string"
    ],
    "add_department_performance_manager_employee_ids": [
        "string"
    ],
    "add_department_performance_manager_ids": [
        "integer"
    ],
    "code": "string",
    "leader_email": [
        "string"
    ],
    "leader_ids": [
        "integer"
    ],
    "leaders_employee_id": [
        "string"
    ],
    "leaders_employee_ids": [
        "string"
    ],
    "name": "string",
    "parent_code": "string",
    "parent_id": "integer",
    "user_emails": [
        "email"
    ],
    "user_ids": [
        "integer"
    ]
}

Properties

Name	Example	Description	Additional
access_groups[]	[ 1, 2 ]	IDs of the access groups that will be inherited by department members	Optional
add_department_learning_manager_emails[]	[ "[email protected]", "[email protected]" ]	Emails of the learning managers in the department to be added	Optional
add_department_learning_manager_employee_ids[]	[ "EI111", "EI222" ]	Employee Id's of the learning managers in the department to be added	Optional
add_department_learning_manager_ids[]	[ 15, 16 ]	IDs of the learning managers in the department to be added	Optional
add_department_organizational_manager_emails[]	[ "[email protected]", "[email protected]" ]	Emails of the organization managers in the department to be added	Optional
add_department_organizational_manager_employee_ids[]	[ "EI111", "EI222" ]	Employee Id's of the organization managers in the department to be added	Optional
add_department_organizational_manager_ids[]	[ 15, 16 ]	IDs of the organization managers in the department to be added	Optional
add_department_performance_manager_emails[]	[ "[email protected]", "[email protected]" ]	Emails of the performance managers in the department to be added	Optional
add_department_performance_manager_employee_ids[]	[ "EI111", "EI222" ]	Employee Id's of the performance managers in the department to be added	Optional
add_department_performance_manager_ids[]	[ 15, 16 ]	IDs of the performance managers in the department to be added	Optional
code	"MAR02"	Your companys id for the department	Optional
leader_email[]	[ "[email protected]", "[email protected]" ]	Emails of the leaders of the department	Optional
leader_ids[]	[ 3, 4 ]	IDs of the leaders of the department	Optional
leaders_employee_id[]	[ "E001", "E002" ]	Employee IDs of the leaders of the department	Optional
leaders_employee_ids[]	[ "E001", "E002" ]	Employee IDs of the leaders of the department	Optional
name	"Inbound Marketing"	Department name is it should appear in eloomi	Required
parent_code	"MAR01"	Your companys id for the parent department	Optional
parent_id	1337	eloomis internal id of the parent department	Optional
user_emails[]	[ "[email protected]" ]	Emails of the users in the department	Optional
user_ids[]	[ 5, 6 ]	IDs of the users in the department	Optional

Response

The following HTTP status codes may be returned, optionally with a response resource.

Status code	Description	Resource
200	OK Department created	DepartmentSuccess
400	Bad Request Request contained invalid data	GenericSuccess
401	Unauthorized Not allowed	ErrorSuccess