---
title: "Create Engagements"
method: POST
path: "/crm/engagements"
tags: ["crm/engagements"]
---

# Create Engagements

`POST /crm/engagements`

Create Engagements in any supported Crm software

## Query parameters

- `remote_data` boolean

## Headers

- `x-connection-token` string, required

## Request body

- UnifiedCrmEngagementInput
  - `content` string, nullable — The content of the engagement
  - `direction` string, nullable — The direction of the engagement. Authorized values are INBOUND or OUTBOUND
  - `subject` string, nullable — The subject of the engagement
  - `start_at` string, date-time, nullable — The start time of the engagement
  - `end_time` string, date-time, nullable — The end time of the engagement
  - `type` string, nullable, required — The type of the engagement. Authorized values are EMAIL, CALL or MEETING
  - `user_id` string, nullable — The UUID of the user tied to the engagement
  - `company_id` string, nullable — The UUID of the company tied to the engagement
  - `contacts` string[], nullable — The UUIDs of contacts tied to the engagement object
  - `field_mappings` object, nullable — The custom field mappings of the engagement between the remote 3rd party & Panora

## Response `201`

- UnifiedCrmEngagementOutput
  - `content` string, nullable — The content of the engagement
  - `direction` string, nullable — The direction of the engagement. Authorized values are INBOUND or OUTBOUND
  - `subject` string, nullable — The subject of the engagement
  - `start_at` string, date-time, nullable — The start time of the engagement
  - `end_time` string, date-time, nullable — The end time of the engagement
  - `type` string, nullable, required — The type of the engagement. Authorized values are EMAIL, CALL or MEETING
  - `user_id` string, nullable — The UUID of the user tied to the engagement
  - `company_id` string, nullable — The UUID of the company tied to the engagement
  - `contacts` string[], nullable — The UUIDs of contacts tied to the engagement object
  - `field_mappings` object, nullable — The custom field mappings of the engagement between the remote 3rd party & Panora
  - `id` string, nullable — The UUID of the engagement
  - `remote_id` string, nullable — The id of the engagement in the context of the Crm 3rd Party
  - `remote_data` object, nullable — The remote data of the engagement in the context of the Crm 3rd Party
  - `created_at` string, date-time, nullable — The created date of the object
  - `modified_at` string, date-time, nullable — The modified date of the object

## 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`
  - …6 more
- **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`
  - …8 more
- **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`
  - …29 more
- **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
  - …14 more
- …earlier changes not shown

[Full history](https://skmtc.dev/panoratech/apis/panora-api-2/changes/crm/engagements/post.md)

---

[API](https://skmtc.dev/panoratech/apis/panora-api-2.md) · [All operations](https://skmtc.dev/panoratech/apis/panora-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/panoratech/panora-api-2/revisions/ef360d76c658/schema)