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

# Create customer

`POST /customers`

Create a new customer for the authenticated team.

## Request body

- object
  - `id` string, uuid — Unique identifier of the customer. Required for updates, omit for new customers
  - `name` string, required — Name of the customer or organization
  - `email` string, email, required — Primary email address of the customer
  - `billingEmail` string, nullable — Billing email addresses of the customer (comma-separated for multiple)
  - `country` string, nullable — Country name where the customer is located
  - `addressLine1` string, nullable — First line of the customer's address
  - `addressLine2` string, nullable — Second line of the customer's address (suite, apartment, etc.)
  - `city` string, nullable — City where the customer is located
  - `state` string, nullable — State or province where the customer is located
  - `zip` string, nullable — ZIP or postal code of the customer's address
  - `phone` string, nullable — Primary phone number of the customer
  - `website` string, nullable — Website URL of the customer
  - `note` string, nullable — Internal notes about the customer for team reference
  - `vatNumber` string, nullable — VAT (Value Added Tax) number of the customer
  - `countryCode` string, nullable — Country code in ISO 3166-1 alpha-2 format
  - `contact` string, nullable — Primary contact person's name at the customer organization
  - `tags` object[] — Array of tags to associate with the customer for categorization
    - `id` string, uuid, required — Unique identifier of the tag
    - `name` string, required — Display name of the tag

## Response `201`

Customer created

- object
  - `id` string, uuid, required — Unique identifier of the customer
  - `name` string, required — Name of the customer or organization
  - `email` string, email, required — Primary email address of the customer
  - `billingEmail` string, nullable, required — Billing email addresses of the customer (comma-separated for multiple)
  - `phone` string, nullable, required — Primary phone number of the customer
  - `website` string, nullable, required — Website URL of the customer
  - `createdAt` string, required — Date and time when the customer was created in ISO 8601 format
  - `country` string, nullable, required — Country name where the customer is located
  - `addressLine1` string, nullable, required — First line of the customer's address
  - `addressLine2` string, nullable, required — Second line of the customer's address (suite, apartment, etc.)
  - `city` string, nullable, required — City where the customer is located
  - `state` string, nullable, required — State or province where the customer is located
  - `zip` string, nullable, required — ZIP or postal code of the customer's address
  - `note` string, nullable, required — Internal notes about the customer for team reference
  - `vatNumber` string, nullable, required — VAT (Value Added Tax) number of the customer
  - `countryCode` string, nullable, required — Country code in ISO 3166-1 alpha-2 format
  - `token` string, required — Unique token for the customer (used for internal identification)
  - `contact` string, nullable, required — Primary contact person's name at the customer organization
  - `invoiceCount` number, required — Total number of invoices created for this customer
  - `projectCount` number, required — Total number of projects associated with this customer
  - `totalRevenue` number — Total revenue from paid invoices for this customer (in invoice currency). Only returned in list queries.
  - `outstandingAmount` number — Total outstanding amount from unpaid/overdue invoices (in invoice currency). Only returned in list queries.
  - `lastInvoiceDate` string, nullable — Date of the most recent invoice in ISO 8601 format. Only returned in list queries.
  - `invoiceCurrency` string, nullable — Primary currency used in invoices for this customer. Only returned in list queries.
  - `tags` object[], required — Array of tags associated with the customer for categorization
    - `id` string, uuid, required — Unique identifier of the tag
    - `name` string, required — Display name of the tag
  - `description` string, nullable, required — AI-generated description of what the company does
  - `industry` string, nullable, required — Primary industry of the company
  - `companyType` string, nullable, required — Business model type
  - `employeeCount` string, nullable, required — Estimated number of employees
  - `foundedYear` number, nullable, required — Year the company was founded
  - `estimatedRevenue` string, nullable, required — Estimated annual revenue range
  - `fundingStage` string, nullable, required — Current funding stage
  - `totalFunding` string, nullable, required — Total funding raised
  - `headquartersLocation` string, nullable, required — Company headquarters location
  - `timezone` string, nullable, required — IANA timezone of the company headquarters
  - `linkedinUrl` string, nullable, required — LinkedIn company page URL
  - `twitterUrl` string, nullable, required — Twitter/X profile URL
  - `instagramUrl` string, nullable, required — Instagram profile URL
  - `facebookUrl` string, nullable, required — Facebook page URL
  - `logoUrl` string, nullable, required — URL to the company logo
  - `ceoName` string, nullable, required — Name of the CEO or founder
  - `financeContact` string, nullable, required — Name of the finance/AP contact for invoicing
  - `financeContactEmail` string, nullable, required — Email of the finance/AP contact
  - `primaryLanguage` string, nullable, required — Primary business language (ISO 639-1 code)
  - `fiscalYearEnd` string, nullable, required — Month when the fiscal year ends
  - `enrichmentStatus` string, nullable, required — Status of the enrichment process
  - `enrichedAt` string, nullable, required — When the customer was last enriched

## Other responses

- `default` — An error occurred

---

[API](https://skmtc.net/midday-ai/apis/midday-api.md) · [All operations](https://skmtc.net/midday-ai/apis/midday-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/midday-ai/midday-api/versions/c0df9243c1b0/schema)