---
title: "Changes to Create Engagements"
method: POST
path: "/crm/engagements"
---

# Changes to Create Engagements

`POST /crm/engagements`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 18 revisions.

- **2024-09-20** `be3dc330edf3` — 5 breaking, 5 info
- **2024-08-05** `ca0fa45ebd05` — 2 breaking, 5 warning, 5 info
- **2024-08-05** `ca213ae36b7f` — 21 breaking, 12 info
- **2024-08-05** `167edd5346ec` — 13 breaking, 5 info
- **2024-08-03** `9d25bd589fe9` — 21 breaking, 11 info
- **2024-08-01** `414c3e999e0b` — 1 info

## Changes

- **2024-09-20** `be3dc330edf3` — 5 breaking, 5 info
  - removed the enum value `CALL` of the request property `type`
  - removed the enum value `EMAIL` of the request property `type`
  - removed the enum value `INBOUND` of the request property `direction`
  - removed the enum value `MEETING` of the request property `type`
  - removed the enum value `OUTBOUND` of the request property `direction`
  - removed the `CALL` enum value from the `type` response property for the response status `201`
  - removed the `EMAIL` enum value from the `type` response property for the response status `201`
  - removed the `INBOUND` enum value from the `direction` response property for the response status `201`
  - removed the `MEETING` enum value from the `type` response property for the response status `201`
  - removed the `OUTBOUND` enum value from the `direction` response property for the response status `201`
- **2024-08-05** `ca0fa45ebd05` — 2 breaking, 5 warning, 5 info
  - request property `direction` was restricted to a list of enum values
  - request property `type` was restricted to a list of enum values
  - added the new `CALL` enum value to the `type` response property for the response status `201`
  - added the new `EMAIL` enum value to the `type` response property for the response status `201`
  - added the new `INBOUND` enum value to the `direction` response property for the response status `201`
  - added the new `MEETING` enum value to the `type` response property for the response status `201`
  - added the new `OUTBOUND` enum value to the `direction` response property for the response status `201`
  - added the new `CALL` enum value to the request property `type`
  - added the new `EMAIL` enum value to the request property `type`
  - added the new `INBOUND` enum value to the request property `direction`
  - added the new `MEETING` enum value to the request property `type`
  - added the new `OUTBOUND` enum value to the request property `direction`
- **2024-08-05** `ca213ae36b7f` — 21 breaking, 12 info
  - the response property `company_id` became nullable for the status `201`
  - the response property `contacts` became nullable for the status `201`
  - the response property `content` became nullable for the status `201`
  - the response property `created_at` became nullable for the status `201`
  - the response property `direction` became nullable for the status `201`
  - the response property `end_time` became nullable for the status `201`
  - the response property `field_mappings` became nullable for the status `201`
  - the response property `id` became nullable for the status `201`
  - the response property `modified_at` became nullable for the status `201`
  - the response property `remote_data` became nullable for the status `201`
  - the response property `remote_id` became nullable for the status `201`
  - the response property `start_at` became nullable for the status `201`
  - the response property `subject` became nullable for the status `201`
  - the response property `type` became nullable for the status `201`
  - the response property `user_id` became nullable for the status `201`
  - the response property `created_at` became optional for the status `201`
  - the response property `field_mappings` became optional for the status `201`
  - the response property `modified_at` became optional for the status `201`
  - the response property `remote_data` became optional for the status `201`
  - the `created_at` response's property type/format changed from `object`/`` to `string`/`date-time` for status `201`
  - the `modified_at` response's property type/format changed from `object`/`` to `string`/`date-time` for status `201`
  - the endpoint scheme security `bearer` was removed from the API
  - the request property `company_id` became nullable
  - the request property `contacts` became nullable
  - the request property `content` became nullable
  - the request property `direction` became nullable
  - the request property `end_time` became nullable
  - the request property `field_mappings` became nullable
  - the request property `start_at` became nullable
  - the request property `subject` became nullable
  - the request property `type` became nullable
  - the request property `user_id` became nullable
  - the request property `field_mappings` became optional
- **2024-08-05** `167edd5346ec` — 13 breaking, 5 info
  - the request property `company_id` became not nullable
  - the request property `contacts` became not nullable
  - the request property `content` became not nullable
  - the request property `direction` became not nullable
  - the request property `end_time` became not nullable
  - the request property `field_mappings` became not nullable
  - the request property `start_at` became not nullable
  - the request property `subject` became not nullable
  - the request property `type` became not nullable
  - the request property `user_id` became not nullable
  - the request property `field_mappings` became required
  - the `created_at` response's property type/format changed from `string`/`date-time` to `object`/`` for status `201`
  - the `modified_at` response's property type/format changed from `string`/`date-time` to `object`/`` for status `201`
  - the endpoint scheme security `bearer` was added to the API
  - the response property `created_at` became required for the status `201`
  - the response property `field_mappings` became required for the status `201`
  - the response property `modified_at` became required for the status `201`
  - the response property `remote_data` became required for the status `201`
- **2024-08-03** `9d25bd589fe9` — 21 breaking, 11 info
  - the response property `company_id` became nullable for the status `201`
  - the response property `contacts` became nullable for the status `201`
  - the response property `content` became nullable for the status `201`
  - the response property `created_at` became nullable for the status `201`
  - the response property `direction` became nullable for the status `201`
  - the response property `end_time` became nullable for the status `201`
  - the response property `field_mappings` became nullable for the status `201`
  - the response property `id` became nullable for the status `201`
  - the response property `modified_at` became nullable for the status `201`
  - the response property `remote_data` became nullable for the status `201`
  - the response property `remote_id` became nullable for the status `201`
  - the response property `start_at` became nullable for the status `201`
  - the response property `subject` became nullable for the status `201`
  - the response property `type` became nullable for the status `201`
  - the response property `user_id` became nullable for the status `201`
  - the response property `created_at` became optional for the status `201`
  - the response property `field_mappings` became optional for the status `201`
  - the response property `modified_at` became optional for the status `201`
  - the response property `remote_data` became optional for the status `201`
  - the `created_at` response's property type/format changed from `object`/`` to `string`/`date-time` for status `201`
  - the `modified_at` response's property type/format changed from `object`/`` to `string`/`date-time` for status `201`
  - the request property `company_id` became nullable
  - the request property `contacts` became nullable
  - the request property `content` became nullable
  - the request property `direction` became nullable
  - the request property `end_time` became nullable
  - the request property `field_mappings` became nullable
  - the request property `start_at` became nullable
  - the request property `subject` became nullable
  - the request property `type` became nullable
  - the request property `user_id` became nullable
  - the request property `field_mappings` became optional
- **2024-08-01** `414c3e999e0b` — 1 info
  - the endpoint scheme security `bearer` was removed from the API

---

[Operation](https://skmtc.dev/panoratech/apis/panora-api-2/docs/crm/engagements/post.md) · [API](https://skmtc.dev/panoratech/apis/panora-api-2.md) · [Page](https://skmtc.dev/panoratech/apis/panora-api-2/changes/crm/engagements/post)
