Create a field map
Use this endpoint to create a field map for a specific source within a context. Field maps define how source fields are mapped to reconciliation fields. A source holds at most one field map: a second create is refused with 409, so update the existing map instead.
Authorizations
Bearer token authentication (format: "Bearer {token}")
Headers
A unique identifier for tracing the request across services.
Optional idempotency key for safe retries. Matcher reads the key only from this header, and only when you send one. A request that carries a key only in X-Idempotency-Key or Idempotency-Key is refused with 400 (MTCH-0015), and nothing is processed. If the same key is sent again and the original request was already processed, the stored response is returned with X-Idempotency-Replayed: true. A malformed key returns 400, a key whose first request is still in progress returns 409, and an idempotency storage failure returns 500. These refusals are problem documents.
Path Parameters
The unique identifier of the reconciliation context. Context ID
The unique identifier of the reconciliation source. Source ID
Body
Field map creation payload
Field-mapping object that normalizes a source's raw columns to canonical transaction fields.
Response
Successfully created field map.
Identifier of the context this field map belongs to.
"550e8400-e29b-41d4-a716-446655440000"
Creation timestamp in RFC 3339 format.
"2025-01-15T10:30:00Z"
Unique identifier of the field map.
"550e8400-e29b-41d4-a716-446655440000"
Field-mapping object normalizing the source's raw columns to canonical transaction fields.
Identifier of the source this field map normalizes.
"550e8400-e29b-41d4-a716-446655440000"
Last update timestamp in RFC 3339 format.
"2025-01-15T10:30:00Z"
Monotonic mutation counter incremented server-side on each field-map change. Read-only on the write path and NOT honored for optimistic concurrency control.
1

