# Create an appointment

**POST /appointments**

Create an appointment


## Servers
- https://api.pexipengage.com/enterprises/acme: https://api.pexipengage.com/enterprises/acme ()


## Authentication methods
- O auth2


## Parameters
#### Headers
- **Authorization** (string)
  Bearer token used for authorization
- **X-Correlation-Id** (string)
  Unique identifier to allow referencing a particular transaction or event chain
- **Accept-Language** (string)
  Returns the requested resources translated according to the passed languages (see [translatable resources](../topic/topic-languages-translations\#topic-translatable-resources))



## Body parameters
Content-type: application/json

- **start** (string(date-time))
  
- **end** (string(date-time))
  
- **subjectId** (string)
  
- **officeId** (string)
  
- **appointmentParticipants** (array[object])
  
- **answers** (array[object] | null)
  
- **callbackRequestId** (string | null)
  
- **location** (object | null)
  
- **listingId** (string | null)
  
- **leadSegmentId** (string | null)
  
- **meetingRoomId** (string | null)
  
- **meetingType** (string)
  
- **externalId** (string | null)
  
- **hybrid** (boolean | null)
  
- **trailingBufferTime** (integer | null)
  
- **internalNotes** (string | null)
  
- **metadata** (object | null)
  
- **messageForCustomer** (string | null)
  
- **userCommunication** (object | null)
  

## Responses
### 201: Successful operation

#### Body Parameters: application/json (object)
- **data** (object)
  

### 422: Business validation failed

* `ANSWER_SELECTED_OPTIONS_FOR_NON_SELECTION_TYPE`
* `ANSWER_VALUE_FOR_SELECTION_TYPE`
* `APPOINTMENT_LOCATION_REQUIRED`
* `APPOINTMENT_NO_AVAILABILITY`
* `APPOINTMENT_PARTICIPANTS_NOT_UNIQUE`
* `APPOINTMENT_PRIMARY_CUSTOMER_MISSING`
* `APPOINTMENT_PRIMARY_EMPLOYEE_MISSING`
* `APPOINTMENT_START_AFTER_END`
* `LOCATION_GEOCODING_FAILED`
* `LOCATION_TIME_ZONE_RESOLUTION_FAILED`

See [Error codes](#topic-error-codes)

#### Body Parameters: application/json (object)
- **errors** (array[object])
  


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