Recommendation Definitions

Community managers (users with the “Create and Set Up Communities” or “Manage Communities” permission) can access, create, and delete audiences, definitions, and schedules for community recommendations. Users with the “Modify All Data” permission can also access, create, and delete recommendation audiences, recommendation definitions, and scheduled recommendations.

Resource

1/connect/recommendation-definitions

1/connect/communities/communityId/recommendation-definitions

Available version

33.0

Requires Chatter

No

HTTP methods

GET, HEAD, POST

Request body for POST

JSON example

1{ 
2   "actionUrl" : "https://www.example.com",
3   "actionUrlName" : "Launch",
4   "explanation" : "Click this link to learn more!",
5   "name" : "Corporate Training Project",
6   "title" : "Want to learn more about Corporate Training Project?"}

Properties

Name	Type	Description	Required or Optional	Available Version
actionUrl	String	The URL for acting on the recommendation, for example, the URL to join a group.	Required	33.0
actionUrlName	String	The text label for the action URL in the user interface, for example, “Launch.”	Required	34.0
explanation	String	The explanation, or body, of the recommendation.	Required	33.0
name	String	The name of the recommendation definition. The name is displayed in Setup.	Required	33.0
title	String	The title of the recommendation definition.	Optional	33.0

Request parameters for POST

Parameter Name	Type	Description	Required or Optional	Available Version
actionUrl	String	The URL for acting on the recommendation, for example, the URL to join a group.	Required	33.0
actionUrlName	String	The text label for the action URL in the user interface, for example, “Launch.”	Required	34.0
explanation	String	The explanation, or body, of the recommendation.	Required	33.0
name	String	The name of the recommendation definition. The name is displayed in Setup.	Required	33.0
title	String	The title of the recommendation definition.	Optional	33.0

Response body for POST

Recommendation Definition

Response body for GET

Recommendation Definition Collection