ARK TMS

MCP documentation | MCP docs for agents

ark_create_location

ark.create_location

Create a team-owned ARK location and address, optionally linked to a customer.

Availability
Expanded preview
Scopes
locations:write
ARK permissions
canCreateLocation
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

teamIdstringrequired

Visible team ID that owns the location.

format: uuid

customerIdstring | null

Optional customer linked to this location.

format: uuid

namestringrequired

min length: 1; max length: 200

companystring | null

max length: 200

addressstring | null

max length: 500

address2string | null

max length: 500

citystring | null

max length: 200

statestring | null

max length: 20

zipstring | null

max length: 30

phonestring | null

max length: 50

emailstring | null

max length: 500

notesstring | null

max length: 5000

internalNotesstring | null

max length: 5000

latitudenumber | null
longitudenumber | null
timezoneIdstringrequired

min length: 1; max length: 100

countrystring

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

Result

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