Add Records
Adds multiple records to an App.
Method | POST |
---|---|
URL | https://{subdomain}.kintone.com/k/v1/records.json |
URL(guest space) | https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/records.json |
Authentication | API Token Authentication, Password Authentication |
Content-Type | application/json |
Contents
Permissions
- Permission to add records into the App is needed.
- Permission to edit fields that are included in the request parameters are needed.
Request Parameters
PARAMETER | VALUE | REQUIRED | DESCRIPTION |
---|---|---|---|
app | Integer | Yes | The App ID. |
records | Array of Objects | Yes | Holds an array of record objects, that contains field codes and their values. Fields that are not included in the objects are added with their default value. Objects containing field codes that do not exist are ignored. For field type specs, check the Field Types page. |
Sample Request
JavaScript (using Kintone REST API Request)
|
|
curl Sample
|
|
Response Parameters
Parameter | Type | Description |
---|---|---|
ids | Array of Strings | The Record IDs of the created records. |
revisions | Array of Strings | The revision numbers of the records. |
Sample Response
|
|
Limitations
To add values to the following fields, you must be the admin of the App:
- Created by
- Updated by
- Created datetime
- Updated datetime
If there are fields with the "Required field" option turned on, those fields must be included in the request.
Values cannot be added to the following fields.
- The Field Mappings targets of the Lookup field
- Status
- Categories
- Calculated
- Assignee
For other limitations, please check the Limitations on this page.