Add Departments
Adds Departments to a Kintone environment.
Method | POST |
---|---|
URL | https://{subdomain}.kintone.com/v1/organizations.json |
Authentication | Password Authentication, Session Authentication |
Content-Type | application/json |
Permissions
Only
Administrators
can use this API.
Request Parameters
Parameter | Value | Required | Description |
---|---|---|---|
organizations | Array of Objects | Yes | An array of organizations objects, containing data of Departments to be added. Up to 100 organizations objects can be specified. |
organizations[].code | String | Yes | The Department Code. The Maximum limit is 128 characters. |
organizations[].name | String | Yes | The new Name of the Department. The Maximum limit is 128 characters. |
organizations[].localName | String | Optional | The Local Name of the Department. The Maximum limit is 128 characters. |
organizations[].localNameLocale | String | Optional | The Locale of the local name. One of "en", "ja" and "zh" can be specified. |
organizations[].parentCode | String | Optional | The Code of parent Department. |
organizations[].description | String | Optional | The Description of the Department. The Maximum limit is 1000 characters. |
Sample Request
JavaScript (using Kintone REST API Request)
|
|
curl Sample
|
|
Sample Response
|
|
Limitations
- The Parent Department stated within the parentCode parameter may also exist inside request parameter array. In this case, the array must include the data of the Parent Department before the Child Department.