---
title: "Create a customer"
method: POST
path: "/customers"
tags: ["Customers"]
---

# Create a customer

`POST /customers`

## Request

- Base URL: `https://api3.autarc.energy/v1`
- URL: `https://api3.autarc.energy/v1/customers`
- Auth: API key in header `X-Api-Key`

## Request body

- CreateCustomerRequest: Company is inferred from API key / access token.
  - `firstName` string, required
  - `lastName` string, required
  - `humanId` string, nullable: Custom customer identifier (e.g., C-001).
  - `email` string, email, nullable
  - `invoiceEmail` string, email, nullable
  - `phoneNumber` string, nullable
  - `isCompany` boolean
  - `companyName` string, nullable
  - `availability` 'morning' | 'afternoon' | 'evening' | 'weekend_only' | 'flexible'
  - `description` string, nullable
  - `website` string, uri, nullable
  - `address` Address, required
    - `addressLine1` string, required
    - `addressLine2` string, nullable
    - `postalCode` string, required
    - `city` string, required
    - `country` string, required
    - `countryCode` string, nullable: The ISO country code.
    - `latitude` number, nullable
    - `longitude` number, nullable

## Response `200`

OK

- Customer
  - `id` string, uuid
  - `firstName` string
  - `lastName` string
  - `companyId` string, uuid
  - `humanId` string, nullable
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `address` Address
    - `addressLine1` string, required
    - `addressLine2` string, nullable
    - `postalCode` string, required
    - `city` string, required
    - `country` string, required
    - `countryCode` string, nullable: The ISO country code.
    - `latitude` number, nullable
    - `longitude` number, nullable
  - `email` string, email, nullable
  - `invoiceEmail` string, email, nullable
  - `phoneNumber` string, nullable
  - `isCompany` boolean
  - `companyName` string, nullable
  - `availability` 'morning' | 'afternoon' | 'evening' | 'weekend_only' | 'flexible'
  - `description` string, nullable
  - `website` string, uri, nullable

## Other responses

- `404`: The specified resource was not found

---

[API](https://skmtc.dev/autarc/apis/autarc-2-0-api.md) - [All operations](https://skmtc.dev/autarc/apis/autarc-2-0-api/llms.txt) - [OpenAPI document](https://skmtc.dev/autarc/apis/autarc-2-0-api/revisions/adfb20a40efc?raw)