# Create Multiple Entity Records

> Creates multiple new Entity records in a batch.

Creates multiple new Entity records in a batch.

## API Endpoint

![docs image](https://dev-assets.cms.uipath.com/assets/images/data-service/data-service-docs-image-43138-2a19635a-e2523966.webp)`BaseURL/EntityService/<Entity>/insert-batch`

* **BaseURL:** `https://{yourDomain}/{organizationName}/{tenantName}/dataservice_`

## Request Headers

| Header | Value |
| --- | --- |
| **Authorization** | Bearer `<access_token>` |
| **Content-Type** | application/json |
:::note
Replace all the values between the angle brackets `<...>` with their corresponding use-case values.

The `<access_token>` is the one you received when you authorized the external application. It is available for 1 hour, then you need to generate a new one, or request a refresh token.
:::

## Query Parameters

| Query Parameter | Data Type | Description | Default Value |
| --- | --- | --- | --- |
| **expansionLevel** (Optional) | `int32` | Specifies the depth of the related records to be retrieved. The value of this parameter can be 1, 2, or 3. | 2 |
| **failOnFirst** (Optional) | `boolean` | Specifies if the Data Service should stop processing the remaining records when a record fails to process. If set to `true`, Data Service will stop processing the remaining records at the first failure. | `false` |

## Request Body (Required)

```
[
  {
    "ClosingDate": "2021-03-04",
    "CreatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "CreateTime": "2021-03-04T10:36:28.230Z",
    "Logo": {
      "Name": "string",
      "Path": "string",
      "Size": 0,
      "Type": "string"
    },
    "Name": "string",
    "Nations": 0,
    "OlymipcsVersion": 0,
    "OpeningDate": "2021-03-04",
    "UpdatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "UpdateTime": "2021-03-04T10:36:28.230Z"
  },
  {
    "ClosingDate": "2021-03-04",
    "CreatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "CreateTime": "2021-03-04T10:36:28.230Z",
    "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "Logo": {
      "Name": "string",
      "Path": "string",
      "Size": 0,
      "Type": "string"
    },
    "Name": "string",
    "Nations": 0,
    "OlymipcsVersion": 0,
    "OpeningDate": "2021-03-04",
    "UpdatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "UpdateTime": "2021-03-04T10:36:28.230Z"
  }
]
```

## Responses

### 200 OK

```
{
  "successRecords": [
    {
      "ClosingDate": "2021-03-04",
      "CreatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "CreateTime": "2021-03-04T10:36:28.236Z",
      "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "Logo": {
        "Name": "string",
        "Path": "string",
        "Size": 0,
        "Type": "string"
      },
      "Name": "string",
      "Nations": 0,
      "OlymipcsVersion": 0,
      "OpeningDate": "2021-03-04",
      "UpdatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "UpdateTime": "2021-03-04T10:36:28.236Z"
    }
  ],
  "failureRecords": {
    "error": "string",
    "record": {
      "ClosingDate": "2021-03-04",
      "CreatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "CreateTime": "2021-03-04T10:36:28.236Z",
      "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "Logo": {
        "Name": "string",
        "Path": "string",
        "Size": 0,
        "Type": "string"
      },
      "Name": "string",
      "Nations": 0,
      "OlymipcsVersion": 0,
      "OpeningDate": "2021-03-04",
      "UpdatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "UpdateTime": "2021-03-04T10:36:28.236Z"
    }
  }
}
```

### 401 Unauthorized

You are not authenticated to access Data Service. Make sure your Assistant or Robot is connected to a modern folder in your account.

### 403 Forbidden

You don't have permission to access the entity, field or record or you are using an unsupported robot type. Please contact your administrator for necessary permissions.