Home / Servers / Square API / create_customer

CreateCustomer

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

CreateCustomer Creates a new customer for a business. You must provide at least one of the following values in your request to this endpoint: - given_name - family_name - company_name - email_address - phone_number [POST /v2/customers]

Name on the gateway: square_api__create_customer · may change things.

Parameters

NameTypeDescription
idempotency_keystringThe idempotency key for the request. For more information, see Idempotency.
given_namestringThe given name (that is, the first name) associated with the customer profile.…
family_namestringThe family name (that is, the last name) associated with the customer profile.…
company_namestringA business name associated with the customer profile. The maximum length for…
nicknamestringA nickname for the customer profile. The maximum length for this value is 100…
email_addressstringThe email address associated with the customer profile. The maximum length for…
addressobjectThe physical address associated with the customer profile. For maximum length…
phone_numberstringThe phone number associated with the customer profile. The phone number must…
reference_idstringAn optional second ID used to associate the customer profile with an entity in…
notestringA custom note associated with the customer profile.
birthdaystringThe birthday associated with the customer profile, in YYYY-MM-DD or MM-DD…
tax_idsobjectThe tax ID associated with the customer profile. This field is available only…

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__create_customer",
  "arguments": {}
}

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 createcustomer tool with idempotency_key set to ….

More from Square API