---
title: create
framework: CloudKit JS
role: symbol
role_heading: Instance Method
platforms: [cloudkit js 1.0+]
path: cloudkitjs/cloudkit.recordsbatchbuilder/create
---

# create

Creates one or more records.

## Declaration

```data
CloudKit.RecordsBatchBuilder create(
	CloudKit.Record|CloudKit.Record[] records,
	optional Object options
);
```

## Parameters

- `records`: A doc://com.apple.cloudkitjs/documentation/CloudKitJS/CloudKit.Record dictionary representing the record to create, if you are creating a single record. If you are creating multiple records, this parameter is an array of doc://com.apple.cloudkitjs/documentation/CloudKitJS/CloudKit.Record dictionaries representing the records to create. Only the values of the fields in the dictionaries are set.
- `options`: A dictionary containing options for this operation. This parameter contains a single desiredKeys key that is an array of field names (String values). Only the fields specified in the array are set.

## Return Value

Return Value The object that received this method call.

## See Also

### Creating and Updating Records

- [createOrUpdate](cloudkitjs/cloudkit.recordsbatchbuilder/createorupdate.md)
- [update](cloudkitjs/cloudkit.recordsbatchbuilder/update.md)
- [forceUpdate](cloudkitjs/cloudkit.recordsbatchbuilder/forceupdate.md)