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

# Create customer

`POST /customers`

## Request

- Base URL: `https://api.pipelinecrm.com/api/v3`
- URL: `https://api.pipelinecrm.com/api/v3/customers`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `app-key`
  - API key in query parameter `api_key` and API key in query parameter `app_key`

## Request body

- object
  - `customer` CustomerCreateWritable
    - `health_score` 'low' | 'middle' | 'high' | 'null', nullable: The health of the relationship with this customer
    - `health_score_description` string, nullable: Explanation or notes for the health score
    - `company_id` integer: The ID of the [company](#tag/companies) to convert to a customer record

## Response `200`

Successful Response

- CustomerAll
  - `id` integer: Unique identifier
  - `created_at` string: Timestamp when the record was created (time zone in user's time zone).
  - `updated_at` string: Timestamp when the record was last touched (time zone in user's time zone).
  - `company_id` integer: The ID of the [company](#tag/companies) associated to this customer
  - `days_in_health` integer: How long the customer relationship has had it's current health score
  - `owner` object: A convenience object to get the full name of the company [owner](#tag/users)
    - `id` integer
    - `full_name` string
  - `health_score` 'low' | 'middle' | 'high' | 'null', nullable: The health of the relationship with this customer
  - `health_score_description` string, nullable: Explanation or notes for the health score

## Other responses

- `422`: The request was understood but a value is missing, invalid or too long.

---

[API](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api.md) · [All operations](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/revisions/53ebfcc83597?raw)