Create Department (since 1.1)

A department is a group type meant to departmentalize an organization in enterprise Speakap.


POST https://api.speakap.io/networks/:eid/departments/

Since

1.1

Use cases

  • Create empty Department
  • Create Department from existing basic (i.e., public, restricted, private or secret) group
  • Create hidden Department

Request

URI:/networks/{enterpriseEID}/departments/
Method:POST
Content-Type:application/json

Authentication

OAuth 2.0

Parameters

Name Type Description
enterpriseEID EID Enterprise network EID

Request body

Name Type Description
name string Unique name for the Business Unit
group object Optional Existing group
group. EID EID Unique entity identifier
group. type string “group”
hidden boolean Whether or not the department is listed in group overviews Default: true

Examples

{
    "name": "Engineers",
    "group": {
        "EID": "FEDCBA1234567890",
        "type": "group"
    }
}

Response

201
Successful creation: returns a Feedback object
400
Invalid data: returns an Error object
403
Unauthorized: returns an Error object
404
Unknown network: returns an Error object