---
title: "Bulk create onboarded carrier contacts"
method: POST
path: "/onboarded-carrier/bulk/contacts"
tags: ["Onboarded Carriers"]
---

# Bulk create onboarded carrier contacts

`POST /onboarded-carrier/bulk/contacts`

Creates multiple onboarded carrier contacts for the authenticated customer in a single request. Each contact entry is validated using the same rules as the single-contact create flow. At least one contact must be valid for the operation to succeed. The operation follows the same authorization, repository, caching, and creation logic as the single-contact create flow. Each `usdot` value must contain digits only, be greater than zero, and be at most 9 digits after normalization.

## Request body

- object
  - `contacts` object[], required — List of contacts to create.
    - `usdot` string, required — Carrier USDOT number. Must contain digits only, be greater than zero, and be at most 9 digits. Leading zeroes are normalized before persistence.
    - `name` string, nullable — Contact name.
    - `phone` string, nullable — Contact phone number.
    - `email` string, nullable — Contact email address.

## Response `200`

Contacts processed successfully.

- object
  - `created_contacts` object[] — List of successfully created contacts.
    - `id` string, uuid
    - `usdot` string
    - `name` string
  - `failed_contacts` object[] — Per-item errors for contacts that were not created.
    - `index` integer — Index of the contact in the original payload.
    - `error` string — Human-readable error message for this item.

## Other responses

- `400` — Bad Request – Invalid request body or all items failed.
- `401` — Unauthorized – Invalid or missing Access-Token.
- `403` — Forbidden – Missing required permission.
- `500` — Internal Server Error.

---

[API](https://skmtc.net/genlogs/apis/auth-api-create-token.md) · [All operations](https://skmtc.net/genlogs/apis/auth-api-create-token/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/genlogs/auth-api-create-token/versions/bf34c2431a21/schema)