> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yativo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Customer

> Register a new customer in your account

<ParamField header="Authorization" type="string" required>
  Bearer token: `Bearer YOUR_ACCESS_TOKEN`
</ParamField>

<ParamField body="email" type="string" required>
  The customer's email address. Must be unique within your account.
</ParamField>

<ParamField body="first_name" type="string" required>
  Customer's legal first name.
</ParamField>

<ParamField body="last_name" type="string" required>
  Customer's legal last name.
</ParamField>

<ParamField body="phone" type="string">
  Customer's phone number in E.164 format (e.g. `+14155552671`).
</ParamField>

<ParamField body="metadata" type="object">
  Arbitrary key-value pairs you can attach to the customer for your own reference.
</ParamField>

<Accordion title="Request/Response Type Definitions">
  ```typescript theme={null}
  interface CreateCustomerRequest {
    email: string;
    first_name: string;
    last_name: string;
    phone?: string;
    metadata?: Record<string, string>;
  }

  interface CreateCustomerResponse {
    status: "success";
    data: {
      id: string;
      email: string;
      first_name: string;
      last_name: string;
      phone?: string;
      status: "pending";
      kyc_status: "not_started";
      created_at: string;
    };
  }
  ```
</Accordion>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://crypto-api.yativo.com/api/v1/customers/create-customer' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
      "email": "jane@example.com",
      "first_name": "Jane",
      "last_name": "Doe",
      "phone": "+14155552671"
    }'
  ```

  ```typescript TypeScript SDK theme={null}
  const customer = await sdk.customers.create({
    email: 'jane@example.com',
    first_name: 'Jane',
    last_name: 'Doe',
  });
  console.log('Customer ID:', customer.data.id);
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "status": true,
    "message": "Customer created successfully",
    "data": {
      "_id": "cust_67e54665e759c943cd376abc",
      "username": "new_customer",
      "email": "customer@example.com",
      "phone_number": "",
      "user_id": "usr_6615c3a1e55d9ff7bc0a1234",
      "createdAt": "2026-03-28T10:00:00.000Z",
      "updatedAt": "2026-03-28T10:00:00.000Z"
    }
  }
  ```
</ResponseExample>