Create up to 100 records | Beezr API

Skip to content

POST/api/v1/records/bulk_create

Creates each record in order. Items succeed or fail independently; failed items are listed in failures with their index.

Auth: X-API-Key
Counts as: 1 request
Idempotency: not supported
Batch limit: up to 100

Headers

X-API-Keystringrequired: Read from your server environment.
Content-Typestringrequired: application/json.

Body parameters

modulestringrequired: The module's table name, shown under the module name on its card in Beezr Designer (for example cm_equipment_requests_base).
dataListarray of objectrequired: 1–100 items.

Returns

HTTP 201. Processed. Check failed and failures.

successbooleanoptional: —
dataobjectoptional: —
data.totalintegeroptional: —
data.createdintegeroptional: —
data.failedintegeroptional: —
data.recordsarray of objectoptional: —
data.records[].idintegeroptional: —
data.failuresarray of objectoptional: —
data.failures[].indexintegeroptional: Position in dataList (bulk create)
data.failures[].idintegeroptional: Record id (bulk update and delete)
data.failures[].dataobjectoptional: —
data.failures[].errorstringoptional: —

Field values come back in the same form the Designer shows them.

Errors

HTTP	Code	What to do
400	`MISSING_REQUIRED_FIELD`	Send the required body fields.
400	`INVALID_DATA`	Check field System names.
400	`KEY_FIELD_UNRESOLVED`	Check the module key field.
401	`AUTHENTICATION_FAILED`	Check the API key.
404	`MODULE_NOT_FOUND`	Copy the module table name.
413	`PAYLOAD_TOO_LARGE`	Send at most 100 items.
429	`RATE_LIMIT_EXCEEDED`	Wait for the rate-limit reset.
429	`TOO_MANY_CONCURRENT_REQUESTS`	Wait; keep at most 2 in flight.
429	`MONTHLY_QUOTA_EXCEEDED`	Stop retries until the 1st.
500	`FIELD_LOAD_FAILED`	Retry later.
500	`INTERNAL_ERROR`	Retry later.

curl --fail-with-body --silent --show-error \
  'https://services.beezr.io/generic/api/v1/records/bulk_create' \
  -H "X-API-Key: $BEEZR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "module": "cm_equipment_requests_base",
  "dataList": [{"title":"Laptop","priority":2},{"title":"Monitor","priority":3}]
}'

const response = await fetch("https://services.beezr.io/generic/api/v1/records/bulk_create", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.BEEZR_API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "module": "cm_equipment_requests_base",
    "dataList": [{"title":"Laptop","priority":2},{"title":"Monitor","priority":3}]
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

import os
import requests

response = requests.post(
    "https://services.beezr.io/generic/api/v1/records/bulk_create",
    headers={"X-API-Key": os.environ["BEEZR_API_KEY"]},
    json={
      "module": "cm_equipment_requests_base",
      "dataList": [{"title":"Laptop","priority":2},{"title":"Monitor","priority":3}]
    }
)
response.raise_for_status()
print(response.json())

{
  "success": true,
  "data": {"total":2,"created":2,"failed":0,"records":[{"id":482913,"title":"Laptop"},{"id":482914,"title":"Monitor"}]}
}

{"success":false,"error":{"code":"AUTHENTICATION_FAILED","message":"Invalid or missing API key"}}