curl -X POST "https://api.dcycle.io/v2/logistic-hubs" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}" \
  -H "Idempotency-Key: 5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      {
        "name": "MAD-01",
        "type": "owned",
        "country": "ES",
        "address": "Calle de la Logística 12, 28042 Madrid",
        "category": "warehouse_ambient",
        "facility_id": "c2a8f6b4-3e1d-4f7a-9b2c-5d6e7f8a9b0c",
        "client_row_id": "HUB-001"
      },
      {
        "name": "PART-BCN",
        "type": "subcontracted",
        "country": "ES",
        "address": "Carrer del Port 3, 08039 Barcelona"
      }
    ]
  }'

import os
import uuid

import requests

response = requests.post(
    "https://api.dcycle.io/v2/logistic-hubs",
    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": [
            {
                "name": "PART-BCN",
                "type": "subcontracted",
                "country": "ES",
                "address": "Carrer del Port 3, 08039 Barcelona",
            }
        ]
    },
    timeout=60,
)
response.raise_for_status()
for item in response.json()["items"]:
    print(item["hub"]["name"], item["hub"]["id"])

{
  "items": [
    {
      "source_row_index": 0,
      "client_row_id": "HUB-001",
      "hub": {
        "id": "4f3e2d1c-0b9a-4876-9543-210fedcba987",
        "organization_id": "a8315ef3-dd50-43f8-b7ce-d839e68d51fa",
        "name": "MAD-01",
        "type": "owned",
        "country": "ES",
        "address": "Calle de la Logística 12, 28042 Madrid",
        "category": "warehouse_ambient",
        "facility_id": "c2a8f6b4-3e1d-4f7a-9b2c-5d6e7f8a9b0c",
        "supercharger": false,
        "status": "active",
        "created_at": "2026-10-20T09:12:44.031Z",
        "updated_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": "HUB-001",
      "error_code": "HUB_NAME_ALREADY_EXISTS",
      "error_params": { "field": "name", "value": "MAD-01" }
    }
  ],
  "rejected": 1,
  "request_id": "b2248a31-0f1b-4a7d-83ce-b29bd5977b4c"
}

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