Home / Servers / Square API / upsert_order_custom_attribute

UpsertOrderCustomAttribute

An MCP tool from the Square API server, hosted on mcp.hjlabs.in.

UpsertOrderCustomAttribute Creates or updates a custom attribute for an order. Use this endpoint to set the value of a custom attribute for a specific order. A custom attribute is based on a custom attribute definition in a… [POST /v2/orders/{order_id}/custom-attributes/{custom_attribute_key}]

Name on the gateway: square_api__upsert_order_custom_attribute · may change things.

Parameters

NameTypeDescription
order_id requiredstringThe ID of the target order.
custom_attribute_key requiredstringThe key of the custom attribute to create or update. This…
custom_attribute requiredobjectThe custom attribute to create or update, with the following fields: - value.…
idempotency_keystringA unique identifier for this request, used to ensure idempotency. For more…

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "square_api__upsert_order_custom_attribute",
  "arguments": {
    "order_id": "…",
    "custom_attribute_key": "…",
    "custom_attribute": "…"
  }
}

Or connect the Square API server directly, which lists 308 tools including this one:

Run in your terminal
claude mcp add --transport http hj-square-api https://mcp.hjlabs.in/mcp/square-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the upsertordercustomattribute tool with order_id set to ….

More from Square API