---
schema_version: "1"
id: 764a0130ef86f70144ba53dfa0fd08281e838302b40008cf0ef101cf18825813
title: Create Engagement Topic
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/service-cloud/field-service-dev/guides/field-service/source-files/actions/actions-obj-createengagementtopic.md
canonical_url: https://developer.salesforce.com/docs/service/field-service-dev/guide/actions-obj-createengagementtopic.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: a0c9665b2ca1b79d80e9e88c07847f9ef9ab9ae4be01a44f2c68cf2dc7b24cb7
products:
  - Field Service Developer Guide
  - Service Cloud Developer Content
---

# Create Engagement Topic

Creates an engagement topic record that connects a given topic ID. For example, a service appointment ID, to a messaging session ID. If an engagement topic for this connection already exists, no action is taken.

This action is available in API version 63.0 and later.

## Supported REST HTTP Methods

**URI:** `/services/data/vXX.X/actions/standard/createEngagementTopic`

**Formats:** JSON, XML

**HTTP Methods:** POST

**Authentication:** `Authorization: Bearer TOKEN`

Where `TOKEN` is a variable.

## Inputs

|Input|Type|Description|
|-----|----|-----------|
|`topicId`|id|Required. The topic’s ID.|

## Outputs

|Output|Type|Description|
|------|----|-----------|
|`completionStatus`|boolean|Defines whether the engagement topic was created successfully.|

## Example

Sample request body:

```nolang
{
  "inputs" : [{
    "topicId" : "08p000000000001AAA"
  }]
}
```

Sample response body:

```nolang
{
  "actionName" : "createEngagementTopic",
  "errors" : null,
  "isSuccess" : true,
  "outputValues" : {
    "completionStatus" : true
  }
}
```