---
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

---

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