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 

InputTypeDescription
topicIdidRequired. The topic’s ID.

Outputs 

OutputTypeDescription
completionStatusbooleanDefines whether the engagement topic was created successfully.

Example 

Sample request body:

1{
2  "inputs" : [{
3    "topicId" : "08p000000000001AAA"
4  }]
5}

Sample response body:

1{
2  "actionName" : "createEngagementTopic",
3  "errors" : null,
4  "isSuccess" : true,
5  "outputValues" : {
6    "completionStatus" : true
7  }
8}