ARK TMS

MCP documentation | MCP docs for agents

ark_create_customer

ark.create_customer

Create an ARK customer profile and assign visible customer teams in one write action.

Availability
Expanded preview
Scopes
customers:write
ARK permissions
canCreateCustomer
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
No
Rate limit
OAuth MCP credential and organization budgets

Input

namestringrequired

Customer name.

min length: 2; max length: 200

codestring | null

Optional customer code.

max length: 50

typestring | null

Optional customer type.

max length: 50

countrystring

one of: USA, CAN, MEX; default: "USA"

defaultCurrencystring

one of: USD, CAD, MXN; default: "USD"

trackingEmailstring | null

Tracking email or delimited email list.

max length: 500

notesstring | null

max length: 5000

businessHoursOpenstring | null

max length: 50

businessHoursClosestring | null

max length: 50

paymentTermIdstring | null

Optional payment term ID.

format: uuid

defaultInvoiceRemitProfileIdstring | null

Optional customer-specific invoice remit profile ID. Use null to inherit the organization default.

format: uuid

teamIdsarray<string>required

Visible team IDs that should be able to access the customer.

min items: 1; max items: 100

Result

The tool returns the canonical ark.create_customer 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.