---
title: "Create mismatch observation alerts"
method: POST
path: "/mismatch-observations"
tags: ["Mismatch alerts"]
---

# Create mismatch observation alerts

`POST /mismatch-observations`

Creates one alert row per standalone USDOT or MC value, and one combined row per item in `pairs`. At least one of `usdots`, `mcs`, or `pairs` must be non-empty. `alert_name` is optional; when omitted or blank, stored as null. `logos` is optional and, when present, is normalized to lowercase, stored in `logos`, and used by mismatch detection. Logo matching remains case-insensitive. Unknown JSON properties are rejected.

## Request body

- ExternalMismatchObservationsRequest
  - `usdots` string[] — USDOT numbers (strings). Each non-empty entry creates one alert.
  - `mcs` string[] — MC numbers (strings). Each non-empty entry creates one alert.
  - `pairs` MismatchObservationPairRequest[] — Paired MC/USDOT identifiers. Each item creates one combined alert row with both MC and USDOT in the stored criteria.
    - `mc` string, required — MC number for the combined alert row.
    - `usdot` string, required — USDOT number for the combined alert row.
  - `logos` string[], nullable — Optional trailer logos list. Each value must be a non-empty string. Values are trimmed, deduplicated, and stored in lowercase format. Matching against the logos catalog.
  - `alert_name` string, nullable — Optional display name; omitted or whitespace-only is stored as null.

## Response `201`

Mismatch alerts created successfully.

- object
  - `message` string, required
  - `data` object, required
    - `created` integer — Number of alerts inserted.

## Other responses

- `400` — Bad request – validation error or empty usdots/mcs/pairs.
- `401` — Unauthorized – Invalid or missing Access-Token.
- `403` — Forbidden – missing permission.
- `500` — Internal Server Error.

---

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