MCP documentation | MCP docs for agents

ark_record_carrier_payments

ark.record_carrier_payments

Record selected READY or INVOICED ARK carrier payments as PAID in one AP workflow, with optional QuickBooks bill payment sync.

Availability
Expanded preview
Scopes
loads:readbilling:write
ARK permissions
canViewLoadscanViewBillingcanMakeAdjustments
Team visibility
Required and enforced
Approval policy
ask_before_write
ARK approval request
Required before execution
Idempotency
Required for external execution
Read-only
No
Destructive
No
External side effect
Yes
Rate limit
OAuth MCP credential and organization budgets

Input

carrierPaymentIdsarray<string>required

Visible READY or INVOICED carrier payment IDs to mark PAID.

min items: 1; max items: 100

referenceNumberstring | null

Optional payment reference number applied to every selected payment.

max length: 100

paidDatestringrequired

Payment date in YYYY-MM-DD format.

queueQuickBooksSyncboolean

Also queue QuickBooks carrier bill payment sync for positive-value bills.

default: false

Result

The tool returns the canonical ark.record_carrier_payments operation result in structuredContent and mirrors the same JSON as text. Errors set isError: true and return a stable error code, message, and optional details.