Note that once a user is added with this API, the Update User Services API needs to be used against this user for the user to have access to kintone services.
| Method | POST |
| URL | https://{subdomain}.kintone.com/v1/users.json |
| Authentication | Password Authentication |
| Content-Type | application/json |
Permissions
Only Administrators can use this API.
Request Parameters
A "users" array consisting of an object formed by the below properties is to be specified in the request. Services of up to 100 users can be updated.
| Parameter | Value | Required | Description |
| code | String | Yes |
The User Code (log-in name). The maximum limit is 128 characters. |
| valid | Boolean | The Status of the user. The default is true. State true for active users, and false for inactive users. |
|
| password | String | Yes |
The password. The maximum limit is 128 characters. |
| name | String | Yes |
The display name. The maximum limit is 128 characters. |
| surName | String |
The Surname. The maximum limit is 128 characters. |
|
| givenName | String |
The Given Name. The maximum limit is 128 characters. |
|
| surNameReading | String |
The Phonetic Surname. The maximum limit is 128 characters. This setting is not displayed when editing user information on the "Departments & Users" page for kintone.com domains. |
|
| givenNameReading | String |
The Phonetic Given Name. The maximum limit is 128 characters. This setting is not displayed when editing user information on the "Departments & Users" page for kintone.com domains. |
|
| localName | String |
The Localizled Name. The maximum limit is 128 characters. This setting is not displayed when editing user information on the "Departments & Users" page for kintone.com domains. |
|
| localNameLocale | String |
The Language for the Localized Name. The maximum limit is 128 characters. This setting is not displayed when editing user information on the "Departments & Users" page for kintone.com domains. |
|
| timezone | String |
The user's timezone. The maximum limit is 256 characters. |
|
| locale | String |
The language settings. The maximum limit is 256 characters. |
|
| description | String |
The description of the user, displayed on the "About me" section of the profile. The maximum limit is 1000 characters. |
|
| phone | String |
The Phone number. The maximum limit is 100 characters. |
|
| mobilePhone | String |
The Mobile phone number. The maximum limit is 100 characters. |
|
| extensionNumber | String |
The Extension number. The maximum limit is 100 characters. |
|
| String |
The E-mail address. The maximum limit is 256 characters. |
||
| callto | String |
The Skype name. Limitations are based on limitations of Skype names. |
|
| url | String |
URL The maximum limit is 256 characters. |
|
| employeeNumber | String |
The Employee ID. The maximum limit is 100 characters. |
|
| birthDate | Date | The Birthday. | |
| joinDate | Date | The Hire Date. | |
| sortOrder | Number |
The priority of the user in lists of users. Users are sorted in the list in ascending order based on this number. Numbers from 0 to 99999999 can be used. |
|
| customItemValues | customItemValue Arrays | A list of pairs of Custom Item codes and Custom Item values for Custom Fields. |
Sample Request
Response Parameters
An empty JSON object will be returned.
Sample Response