Create department

Prev Next

Available in Classic and VPC

It is an API to create departments in the Media Connect Center. Customers can add the department information of their client companies through this API.

Requests

POST https://ncloudmcc.apigw.ntruss.co/ncloudmcc/v1/companies/{companyId}/depts/{externalKey}

Request headers

Item Required Description
x-ncp-apigw-timestamp Y Time elapsed since January 1, 1970, 00:00:00 UTC in milliseconds. The request is considered invalid if the time difference from the API Gateway server is 5 minutes or longer
x-ncp-apigw-timestamp:{Timestamp}
x-ncp-iam-access-key Y Value of access key ID issued from NAVER Cloud Platform portal
x-ncp-iam-access-key:{Sub Account Access Key}
x-ncp-apigw-signature-v2 Y Signature encrypted with the access key ID value and secret key
x-ncp-apigw-signature-v2:{API Gateway Signature}
x-ncp-region_code N Region code (KR)
x-ncp-region_code:KR
Content-Type Y Specifies the request body content type as application/json
Content-Type: application/json

Request path parameters

Parameters Type Size Required Description
companyId String 36 Y Integration key (CompanyId)
Developers > Basic settings > Integration key
externalKey String 36 Y External key of department

Request body parameters

Parameters Type Size Required Description
name String 100 Y Department name
i18nNames Map N Multilingual department name
Map<Locale, String> i18nNames
sortOrd Number 1 Y Order of department to be exposed
uprDeptExternalKey String 50 N External key of the upper department; the highest default department if not specified

Request examples

POST /ncloudmcc/v1/companies/48128f23-e29b-496e-aa04-1f741fed86bc/depts/dept01 
Host: ncloudmcc.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: ZYPQDU/KSzfXYFubgoLomAwAuOjLV4AEzE3AQuXAA0Y=
x-ncp-apigw-timestamp: 1700454086935
x-ncp-iam-access-key: HrR0s91elfiXEeTSZcwj
x-ncp-region_code: KR

{
    "name":"sales",
    "i18nNames": 
    {
         "ko_KR": "영업",
         "en_US":"Sales"
    },
    "uprDeptExternalKey": "dept00",
    "sortOrd":0
}

Responses

Response examples

HTTP/1.1 201 Created
Content-Length: 0
Connection: keep-alive
Date: Mon, 20 Nov 2023 04:13:38 GMT
Server: nginx
x-ncp-apigw-response-origin: ENDPOINT
x-ncp-trace-id: 6aeb16oqj2e353gp9p6dh68d1m