API documentation | API docs for agents | OpenAPI 3.1

POST /api/v1/loads

ark.create_load

Creates an available load with customer, team, equipment, route stops, references, and optional customer charges.

Availability

Core preview

Scopes

loads:write

ARK permissions

canCreateLoad

Team visibility

Required and enforced

Idempotency-Key

Required for this write

Approval

No MCP approval on REST API-token calls

Rate limit

API credential and organization budgets

Parameters

Idempotency-Keyheaderstringrequired

Required for external write operations. Reuse the same key only for exact retries of the same request body.

min length: 1; max length: 200

Request body

Example request

curl -X POST 'https://arktms.com/api/v1/loads' \
  -H "Authorization: Bearer $ARK_API_TOKEN" \
  -H "Idempotency-Key: <unique-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "customerId": "<customerId>",
  "teamId": "<teamId>",
  "trailer": "<trailer>",
  "stops": [
    {
      "locationId": "<locationId>",
      "index": 0,
      "type": "<type>"
    },
    {
      "locationId": "<locationId>",
      "index": 0,
      "type": "<type>"
    }
  ]
}'

Success response

Created load

Errors

HTTP 400

Invalid request

HTTP 401

Authentication required

HTTP 403

Permission, scope, team, or entitlement denied

HTTP 409

Idempotency conflict or in-progress retry