Create department
- Print
- PDF
Create department
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
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 longerx-ncp-apigw-timestamp:{Timestamp} |
| x-ncp-iam-access-key | Y | Value of access key ID issued from NAVER Cloud Platform portalx-ncp-iam-access-key:{Sub Account Access Key} |
| x-ncp-apigw-signature-v2 | Y | Signature encrypted with the access key ID value and secret keyx-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/jsonContent-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 nameMap<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
Was this article helpful?