Create Business Unit (since 1.1)

A Business Unit is the top-most organizational unit in enterprise Speakap.


POST https://api.speakap.io/networks/:eid/business-units/

Since

1.1

Use cases

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

Request

URI:/networks/{enterpriseEID}/business-units/
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”

Examples

{
    "name": "Headquarters",
    "group": {
        "EID": "0ABCDEF123456789",
        "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