curl -X POST "https://api.dcycle.io/v2/employees" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}" \
  -H "Idempotency-Key: 8a7b6c5d-4e3f-4a21-9b0c-1d2e3f4a5b6c" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      {
        "email": "ana.garcia@example.com",
        "name": "Ana García",
        "situation": "active",
        "client_row_id": "HR-1042"
      }
    ]
  }'

import os
import uuid

import requests

response = requests.post(
    "https://api.dcycle.io/v2/employees",
    headers={
        "x-api-key": os.environ["DCYCLE_API_KEY"],
        "x-organization-id": os.environ["DCYCLE_ORG_ID"],
        "Idempotency-Key": str(uuid.uuid4()),  # keep it to retry this same batch
    },
    json={
        "records": [
            {
                "email": "ana.garcia@example.com",
                "name": "Ana García",
                "situation": "active",
                "client_row_id": "HR-1042",
            }
        ]
    },
    timeout=60,
)
response.raise_for_status()
print([item["employee"]["id"] for item in response.json()["items"]])

{
  "items": [
    {
      "source_row_index": 0,
      "client_row_id": "HR-1042",
      "employee": {
        "id": "4c3b2a19-0f8e-4d7c-9b6a-5f4e3d2c1b0a",
        "organization_id": "a8315ef3-dd50-43f8-b7ce-d839e68d51fa",
        "email": "ana.garcia@example.com",
        "name": "Ana García",
        "situation": "active",
        "status": "loading",
        "created_at": "2026-10-20T09:12:44.031Z"
      }
    }
  ]
}

{
  "type": "https://code.dcycle.io/api-reference/errors#BULK_RECORDS_REJECTED",
  "title": "Unprocessable Entity",
  "status": 422,
  "code": "BULK_RECORDS_REJECTED",
  "detail": "1 of the submitted records are invalid; nothing was written.",
  "errors": [
    {
      "source_row_index": 0,
      "client_row_id": "HR-1042",
      "error_code": "EMPLOYEE_ALREADY_EXISTS",
      "error_params": {
        "field": "email",
        "value": "ana.garcia@example.com",
        "employee_id": "4c3b2a19-0f8e-4d7c-9b6a-5f4e3d2c1b0a"
      }
    }
  ],
  "rejected": 1,
  "request_id": "b2248a31-0f1b-4a7d-83ce-b29bd5977b4c"
}

{ "dry_run": true, "submitted": 1, "valid": 1 }