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

# Create customer

`POST /customers`

## Request

- Base URL: `https://api.getmaintainx.com/v1`
- URL: `https://api.getmaintainx.com/v1/customers`
- Auth: HTTP bearer

## Headers

- `x-organization-id` integer

## Request body

- object
  - `name` string, required: Name of the customer
  - `description` string, nullable: Description of the customer
  - `extraFields` object: Customer custom fields, keyed by field label

## Response `201`

Successfully created customer

- object
  - `id` integer, required: Global ID of the customer

## Other responses

- `400`: Invalid request
- `401`: Invalid token
- `403`: Forbidden

## Changes

> 30 revisions in range; 1 not diffed.

- **2026-10-06** `11e50c87dcf0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getmaintainx/apis/maintainx-api/changes/customers/post.md)

---

[API](https://skmtc.dev/getmaintainx/apis/maintainx-api.md) - [All operations](https://skmtc.dev/getmaintainx/apis/maintainx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getmaintainx/apis/maintainx-api/revisions/6258367c04ff?raw)