Skip to navigation
Quick start

Create your first customer

Create a customer and connect them to the corresponding user in your existing system.
View as Markdown

Customers represent the people who use your product. Creating a customer gives you a record that you can use across Agent Wallets, MCP access, payments and events.

Creating customers with OAuth

If your product uses OAuth, you do not need to create the customer before they connect. When the customer signs in for the first time, their identity can be used to create or associate their customer record automatically.

Learn more in Connect customer accounts.

Use client_reference_id to connect the customer to the corresponding user in your own system. This lets you keep your existing customer model while using Mitu for agent and payment experiences.

1

Create a customer

Send a request with the customer information you want to store. Set client_reference_id to the identifier you already use for the customer in your own system.

Request
curl --request POST \
  --url https://api.mitu.ai/v1/customers \
  --header "x-api-key: $MITU_API_KEY" \
  --header "Idempotency-Key: customer-your_user_8841" \
  --header "Content-Type: application/json" \
  --data '{
    "client_reference_id": "your_user_8841",
    "first_name": "Ada",
    "last_name": "Obi",
    "email": "ada@example.com",
    "phone": "+2348099887766"
  }'

A successful request creates the customer and returns their customer ID, reference, MCP credentials and other customer information.

201 Created
{
  "id": "cus_ds9hazr8jd3l",
  "client_reference_id": "your_user_8841",
  "first_name": "Ada",
  "last_name": "Obi",
  "email": "ada@example.com",
  "phone": "+2348099887766",
  "key": "mcpk_3a6f9d2a6bbc816b11d524fe052b26b7e75fb7b5fa7a1a7d",
  "mcp_url": "https://mcp.yourdomain.com/mcp",
  "created_at": "2026-09-11T15:00:34.915Z"
}
2

Save the customer

Keep the customer ID and your own customer reference together so you can identify the same customer across both systems.

FieldDescription
idThe Mitu customer ID. Use this when making API requests for the customer, such as issuing an Agent Wallet.
client_reference_idThe customer identifier from your own system. It is included in customer related activity so you can associate it with your existing customer record.
keyThe customer’s MCP key. It is returned only when it is created and can be used when the customer connects to MCP using a key instead of OAuth.
mcp_urlThe MCP URL that the customer can connect to from a supported AI client.

Store the id alongside the corresponding customer in your system. For this example, cus_ds9hazr8jd3l belongs to the customer identified as your_user_8841.

Customer MCP keys

The key belongs to the customer and should not be stored as a merchant credential. If you provide the key to the customer, treat it as a sensitive credential and only deliver it through a secure flow.

3

Handle retries safely

Include an Idempotency-Key when creating a customer. This allows you to retry the request without accidentally creating the customer more than once.

When the same idempotency key is used with the same request, the original successful response is returned. If the same key is reused with different request data, the API returns a 409 response.

The client_reference_id also identifies the customer using the identifier from your own system. Reusing the same reference resolves to the same customer rather than creating another customer.

4

Retrieve the customer

You can retrieve customers later using the API. The following request returns customers associated with your account.

Request
curl --request GET \
  --url "https://api.mitu.ai/v1/customers?limit=20" \
  --header "x-api-key: $MITU_API_KEY"

To retrieve a specific customer, use their customer ID.

Request
curl --request GET \
  --url https://api.mitu.ai/v1/customers/cus_ds9hazr8jd3l \
  --header "x-api-key: $MITU_API_KEY"

Continue building

Now that you have created a customer, you can issue an Agent Wallet or learn how existing customer accounts can connect to AI clients.

Issue your first wallet

Issue an Agent Wallet that the customer’s AI agents can use to make payments on their behalf.

Connect customer accounts

Learn how customers can connect using customer keys or your existing OAuth sign in flow.