# Create a customer

**POST /customers**

Create a new customer record for a company or a person, and get the newly created customer in return.

For a new company customer, define "name" property and set "isCompany" flag to true in the request body. For a new private person customer, define "firstName" and "lastName" under the "person" property, and set "isCompany" flag to false in the request body. These are the minimum required properties that should be defined in the request body for creating a new customer.

All other properties for a customer (see response attributes for each property description) can also be defined in the request body, except for "person" when a new customer is a company, and "organizationNumber" and "name" (this one is generated from "firstName" and "lastName" under the "person" property) when a new customer is a person.



## Servers
- https://rest.api.24sevenoffice.com/v1: https://rest.api.24sevenoffice.com/v1 ()


## Authentication methods
- Tfso


## Parameters
### Headers
- **Authorization** (string)
  Authorization header



### Body: application/json (object)

- **isCompany** (boolean)
  Discriminator flag set to true - indicating that the customer is a company.
- **name** (string)
  A human-readable name or label for a customer, making it easily identifiable to users.
- **organizationNumber** (string | null)
  The organization number issued by authorities, like a VAT number, of the customer.
- **id** (number | null)
  A unique identifier for the customer within Finago Office CRM. This ID is used for reference and linking transactions to specific customers.
- **isSupplier** (boolean)
  A flag variable indicating whether the customer is also a supplier (true) or not (false).
- **address** (object)
  Addresses for the customer.
- **email** (object)
  Email addresses for the customer.
- **phone** (string | null)
  A phone number for contacting the customer.


## Responses
### 200
Created
#### Headers
- **Access-Control-Allow-Origin** (string)

- **Access-Control-Allow-Credentials** (string)

- **X-Trace-Id** (string)


#### Body: application/json (object)
- **id** (integer(int32))
  A unique identifier for the customer within Finago Office CRM. This ID is used for reference and linking transactions to specific customers.
- **name** (string | null)
  A human-readable name or label for a customer, making it easily identifiable to users.
- **person** (object)
  The first and the last name of a customer if the customer is a person.
- **isCompany** (boolean)
  A flag variable indicating whether the customer is a company (true) or a person (false).
- **isSupplier** (boolean)
  A flag variable indicating whether the customer is also a supplier (true) or not (false).
- **organizationNumber** (string | null)
  The organization number issued by authorities, like a VAT number, of the customer if the customer is a company.
- **address** (object)
  Addresses for the customer.
- **email** (object)
  Email addresses for the customer.
- **phone** (string | null)
  A phone number for contacting the customer.
- **createdAt** (string)
  A timestamp for when a record was created, in ISO 8601 format.
- **modifiedAt** (string)
  A timestamp for when one of the properties of a record was last modified, in ISO 8601 format.

### 401
Unauthorized. Missing or invalid bearer token.
#### Headers
- **Access-Control-Allow-Origin** (string)

- **Access-Control-Allow-Credentials** (string)

- **X-Trace-Id** (string)



[Powered by Bump.sh](https://bump.sh)