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

# Create Customer

Creates a new customer without an initial subscription.

<Warning>
  **Deprecated:** Use [provisionCustomer](/api-and-sdks/api-reference/mutations/provision-customer) instead, which can create both customer and subscription in a single operation.
</Warning>

## Mutation

<CodeGroup>
  ```graphql Mutation theme={null}
  mutation CreateCustomer($input: CustomerInput!) {
    createOneCustomer(input: $input) {
      customerId
      name
      email
      billingId
      createdAt
    }
  }
  ```

  ```json Variables theme={null}
  {
    "input": {
      "customerId": "customer-123",
      "name": "Acme Corp",
      "email": "billing@acme.com"
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "createOneCustomer": {
        "customerId": "customer-123",
        "name": "Acme Corp",
        "email": "billing@acme.com",
        "billingId": null,
        "createdAt": "2024-01-15T10:30:00Z"
      }
    }
  }
  ```
</CodeGroup>

## Parameters

<ParamField body="input" type="CustomerInput" required>
  Input for creating a customer

  <Expandable title="properties">
    <ParamField body="customerId" type="String">
      Your unique identifier for this customer. Auto-generated if not provided.
    </ParamField>

    <ParamField body="name" type="String">
      Customer display name
    </ParamField>

    <ParamField body="email" type="String">
      Customer email address
    </ParamField>

    <ParamField body="billingId" type="String">
      Existing billing provider customer ID
    </ParamField>

    <ParamField body="billingInformation" type="CustomerBillingInfo">
      Billing details
    </ParamField>

    <ParamField body="couponRefId" type="String">
      Customer-level coupon
    </ParamField>

    <ParamField body="additionalMetaData" type="JSON">
      Custom metadata
    </ParamField>

    <ParamField body="crmId" type="String">
      CRM integration ID (HubSpot)
    </ParamField>

    <ParamField body="salesforceId" type="String">
      Salesforce ID
    </ParamField>

    <ParamField body="awsMarketplaceCustomerId" type="String">
      AWS Marketplace customer ID
    </ParamField>

    <ParamField body="environmentId" type="UUID">
      Environment ID
    </ParamField>
  </Expandable>
</ParamField>

## Return Type

Returns a `Customer` object with all customer fields.

## Related Operations

* [Provision Customer](/api-and-sdks/api-reference/mutations/provision-customer) - Create with subscription
* [Update Customer](/api-and-sdks/api-reference/mutations/update-customer) - Modify customer