Add Departments

Adds Departments to a kintone environment..
Method POST
URL https://{subdomain}.kintone.com/v1/organizations.json
Authentication Password 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.
Was this article helpful?
0 out of 0 found this helpful
Do you have any questions or issues related to this article?
Please share your views with us in the Community forums!