Experience Cloud Connect REST API
Experience Cloud Connect REST API (v67.0)
Download OpenAPI specification:Download
Note: The API Reference has a new three-panel layout. Browse grouped endpoints on the left, review endpoint details in the center, and access examples on the right.
Important: Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.
Get, save, and submit marketing integration forms for an Experience Cloud site.
Experience Cloud Microsites resources make calls to the Marketing Cloud Engagement REST API to create, query, and insert data to the data extension object. If the API returns errors, Connect REST API error messages include the error code and message from Marketing Cloud Engagement.
Microsites Marketing Integration Forms
Save a marketing integration form for an Experience Cloud site.
This API attempts to create a read-only data extension in Marketing Cloud Engagement. A Marketing Cloud Engagement admin can change the read-only setting. We recommend keeping the data extension as read-only to maintain schema consistency with the form.
Available in: v53.0
path Parameters
| siteId required | string <Id> ^(0DM)\w* ID of an Experience Cloud site. |
Request Body schema: application/json
Marketing integration form.
required | Array of objects (FormFieldInput) Fields for the marketing integration form. Available in: v53.0 |
| formName required | string Name of the marketing integration form. Available in: v53.0 |
| memberIdentificationCode required | string The member identification code (MID) of the Marketing Cloud Engagement account associated with the form. Available in: v53.0 |
Responses
Request samples
- Payload
{- "formFieldsList": {
- "formFields": [
- {
- "name": "First Name",
- "type": "Text"
}, - {
- "name": "Last Name",
- "type": "Text"
}, - {
- "name": "Email",
- "type": "EmailAddress"
}
]
}, - "formName": "Contact Us Data",
- "memberIdentificationCode": "marketing-account-id"
}Response samples
- 200
{- "dataExtensionId": "string",
- "formFieldsList": {
- "formFields": [
- {
- "name": "string",
- "type": "Boolean"
}
]
}, - "formId": "string",
- "formName": "string"
}Microsites Marketing Integration Form
Get a marketing integration form for an Experience Cloud site.
Available in: v53.0
path Parameters
| formId required | string <Id> ^(8Cm)\w* ID of the form. |
| siteId required | string <Id> ^(0DM)\w* ID of an Experience Cloud site. |
Responses
Response samples
- 200
{- "dataExtensionId": "string",
- "formFieldsList": {
- "formFields": [
- {
- "name": "string",
- "type": "Boolean"
}
]
}, - "formId": "string",
- "formName": "string"
}Microsites Marketing Integration Form Data
Submit a marketing integration form for an Experience Cloud site.
Available in: v53.0
path Parameters
| formId required | string <Id> ^(8Cm)\w* ID of the form. |
| siteId required | string <Id> ^(0DM)\w* ID of an Experience Cloud site. |
Request Body schema: application/json
Marketing integration form submission.
required | Array of objects (FormSubmissionFieldInput) Fields for the marketing integration form. Available in: v53.0 |
Responses
Request samples
- Payload
{- "formFieldsList": {
- "formFields": [
- {
- "name": "First Name",
- "value": "Test"
}, - {
- "name": "Last Name",
- "value": "Moore"
}, - {
- "name": "Email",
- "value": "testMoore@test.com"
}
]
}
}Response samples
- 200
{- "formSubmissionId": "string"
}Get trending articles for an Experience Cloud site. Get trending and top-viewed articles for a topic in an Experience Cloud site. Increase article view counts.
Experience Cloud Site Trending Articles for a Topic
Get trending articles for a topic in an Experience Cloud site.
Available in: v36.0
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
| topicId required | string <Id> ^(0TO)\w* ID of the topic. |
query Parameters
| maxResults | integer The maximum number of articles returned. Values can be from 0 to 25. Default is 5. Available in: v36.0 |
Responses
Response samples
- 200
{- "items": [
- {
- "articleType": "string",
- "id": "string",
- "knowledgeArticleId": "string",
- "lastPublishedDate": "2019-08-24T14:15:22Z",
- "summary": "string",
- "title": "string",
- "urlName": "string"
}
]
}Experience Cloud Site Trending Articles
Get trending articles for an Experience Cloud site.
Available in: v36.0
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
query Parameters
| maxResults | integer The maximum number of articles returned. Values can be from 0 to 25. Default is 5. Available in: v36.0 |
Responses
Response samples
- 200
{- "items": [
- {
- "articleType": "string",
- "id": "string",
- "knowledgeArticleId": "string",
- "lastPublishedDate": "2019-08-24T14:15:22Z",
- "summary": "string",
- "title": "string",
- "urlName": "string"
}
]
}Get information about whether a user has flagged a file as inappropriate. Delete flags on files. Get audit statistics for a user in an Experience Cloud site.
Experience Cloud Sites Moderation User Audit Statistics
Get audit statistics for a user in an Experience Cloud site.
Available in: v40.0
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
| userId required | string <IdOrMe> ^(005)\w*|me ID of the user. |
Responses
Response samples
- 200
{- "auditActionToCount": {
- "property1": 0,
- "property2": 0
}
}Flagged Files
Files that are flagged.
Available in: v36.0
Note: In version 30.0–35.0, use /connect/communities/{communityId}/chatter/files/moderation.
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
query Parameters
| page | integer Specifies the number of the page you want returned. Available in: v30.0 |
| pageSize | integer Specifies the number of items per page. Valid values are from 1 through 100. If you don't specify a size, the default is 25. Available in: v30.0 |
| q | string A query string to filter the results. The string must contain at least two characters, not including wildcards. For information about wildcards, see Wildcards. Available in: v33.0 |
Responses
Response samples
- 200
{- "currentPageUrl": "string",
- "files": [
- {
- "checksum": "string",
- "contentHubRepository": {
- "authentication": {
- "authFlowUrl": "string",
- "authProtocol": "NoAuthentication",
- "userHasAuthSettings": true
}, - "features": {
- "canBrowse": true,
- "canSearch": true
}, - "id": "string",
- "label": "string",
- "motif": {
- "color": "string",
- "largeIconUrl": "string",
- "mediumIconUrl": "string",
- "smallIconUrl": "string",
- "svgIconUrl": "string"
}, - "mySubscription": {
- "id": "string",
- "url": "string"
}, - "name": "string",
- "providerType": {
- "label": "string",
- "type": "string"
}, - "rootFolderItemsUrl": "string",
- "type": "string",
- "url": "string"
}, - "contentModifiedDate": "string",
- "contentSize": 0,
- "contentUrl": "string",
- "contentVersionId": "string",
- "createdDate": "string",
- "description": "string",
- "downloadUrl": "string",
- "externalDocumentUrl": "string",
- "externalFilePermissionInformation": {
- "externalFilePermissionTypes": [
- {
- "id": "string",
- "label": "string"
}
], - "externalFilePermissionsFailure": true,
- "externalFilePermissionsInfoFailureReason": "string",
- "externalFileSharingStatus": "DomainSharing",
- "repositoryPublicGroups": [
- {
- "domain": "string",
- "email": "string",
- "groupType": "Everybody",
- "id": "string",
- "name": "string",
- "type": "GroupEntry"
}
]
}, - "fileExtension": "string",
- "fileType": "string",
- "flashRenditionStatus": "string",
- "id": "string",
- "isFileAsset": true,
- "isInMyFileSync": true,
- "isMajorVersion": true,
- "mimeType": "string",
- "moderationFlags": {
- "flagCount": 0,
- "flagCountByReason": {
- "property1": 0,
- "property2": 0
}, - "flaggedByMe": true,
- "flags": {
- "currentPageToken": "string",
- "currentPageUrl": "string",
- "flags": [
- {
- "createdBy": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "id": "string",
- "moderationType": "FlagAsInappropriate",
- "note": "string",
- "visibility": "ModeratorsOnly"
}
], - "nextPageToken": "string",
- "nextPageUrl": "string",
- "pageSize": 0
}
}, - "modifiedDate": "string",
- "motif": {
- "color": "string",
- "largeIconUrl": "string",
- "mediumIconUrl": "string",
- "smallIconUrl": "string",
- "svgIconUrl": "string"
}, - "mySubscription": {
- "id": "string",
- "url": "string"
}, - "name": "string",
- "origin": "string",
- "owner": {
- "additionalLabel": "string",
- "communityNickname": "string",
- "companyName": "string",
- "displayName": "string",
- "firstName": "string",
- "id": "string",
- "isActive": true,
- "isChatterGuest": true,
- "isInThisCommunity": true,
- "lastName": "string",
- "motif": {
- "color": "string",
- "largeIconUrl": "string",
- "mediumIconUrl": "string",
- "smallIconUrl": "string",
- "svgIconUrl": "string"
}, - "mySubscription": {
- "id": "string",
- "url": "string"
}, - "name": "string",
- "outOfOffice": {
- "message": "string"
}, - "photo": {
- "fullEmailPhotoUrl": "string",
- "largePhotoUrl": "string",
- "mediumPhotoUrl": "string",
- "photoVersionId": "string",
- "smallPhotoUrl": "string",
- "standardEmailPhotoUrl": "string",
- "url": "string"
}, - "reputation": {
- "reputationLevel": {
- "levelImageUrl": "string",
- "levelName": "string",
- "levelNumber": 0
}, - "reputationPoints": 0.1,
- "url": "string"
}, - "stamps": [
- {
- "description": "string",
- "id": "string",
- "imageUrl": "string",
- "label": "string"
}
], - "title": "string",
- "type": "string",
- "url": "string",
- "userType": "ChatterGuest"
}, - "parentFolder": {
- "id": "string",
- "url": "string"
}, - "pdfRenditionStatus": "string",
- "publishStatus": "PendingAccess",
- "renditionUrl": "string",
- "renditionUrl240By180": "string",
- "renditionUrl720By480": "string",
- "repositoryFileId": "string",
- "repositoryFileUrl": "string",
- "sharingOption": "Allowed",
- "sharingPrivacy": "None",
- "sharingRole": "Admin",
- "systemModstamp": "string",
- "textPreview": "string",
- "thumb120By90RenditionStatus": "string",
- "thumb240By180RenditionStatus": "string",
- "thumb720By480RenditionStatus": "string",
- "title": "string",
- "type": "string",
- "url": "string",
- "versionNumber": "string"
}
], - "nextPageUrl": "string",
- "previousPageUrl": "string"
}Moderation Flags on Files
If the context user is a moderator, get the number of times members flagged a file.
If the context user isn’t a moderator, get whether the user flagged a file. Also flag a file for moderation and remove a flag the user previously added.
Available in: v36.0
Note: In versions 30.0–35.0, use /connect/communities/{communityId}/chatter/files/{fileId}/moderation-flags.
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
| fileId required | string <Id> ^(069)\w* ID of a file. |
query Parameters
| page | string Specifies the page token to use to view a page of information.
Page tokens are returned as part of the response class, such as Available in: v40.0 |
| pageSize | integer Specifies the number of items per page. Valid values are from 1 through 100. The default size is 0. Available in: v40.0 |
| visibility | string (ConnectNetworkModerationVisibilityEnum) Enum: "ModeratorsOnly" "SelfAndModerators" Visibility behavior of a flag for various user types.
Available in: v30.0 |
Responses
Response samples
- 200
{- "flagCount": 0,
- "flagCountByReason": {
- "property1": 0,
- "property2": 0
}, - "flaggedByMe": true,
- "flags": {
- "currentPageToken": "string",
- "currentPageUrl": "string",
- "flags": [
- {
- "createdBy": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "id": "string",
- "moderationType": "FlagAsInappropriate",
- "note": "string",
- "visibility": "ModeratorsOnly"
}
], - "nextPageToken": "string",
- "nextPageUrl": "string",
- "pageSize": 0
}
}Moderation Flags on Files
If the context user is or isn’t a moderator, flag a file for moderation.
Available in: v36.0
Note: In versions 30.0–35.0, use /connect/communities/{communityId}/chatter/files/{fileId}/moderation-flags.
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
| fileId required | string <Id> ^(069)\w* ID of a file. |
query Parameters
| note | string A note of up to 4,000 characters about the flag. Available in: v38.0 |
| type | string (ConnectNetworkModerationTypeEnum) Enum: "FlagAsInappropriate" "FlagAsSpam" Type of moderation flag.
If not specified, Available in: v38.0 |
| visibility | string (ConnectNetworkModerationVisibilityEnum) Enum: "ModeratorsOnly" "SelfAndModerators" Visibility behavior of a flag for various user types.
Available in: v30.0 |
Request Body schema: application/json
Moderation flag input.
Available in: v38.0
| note | string A note of up to 4,000 characters about the flag. Available in: v38.0 |
| type | string (ConnectNetworkModerationTypeEnum) Enum: "FlagAsInappropriate" "FlagAsSpam" Type of moderation flag.
Available in: v38.0 |
| visibility | string (ConnectNetworkModerationVisibilityEnum) Enum: "ModeratorsOnly" "SelfAndModerators" Visibility behavior of a flag for various user types.
Available in: v30.0 |
Responses
Request samples
- Payload
{- "note": "Flagged by moderator as spam on 6.6.16.",
- "type": "FlagAsSpam",
- "visibility": "ModeratorsOnly"
}Response samples
- 200
{- "flagCount": 0,
- "flagCountByReason": {
- "property1": 0,
- "property2": 0
}, - "flaggedByMe": true,
- "flags": {
- "currentPageToken": "string",
- "currentPageUrl": "string",
- "flags": [
- {
- "createdBy": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "id": "string",
- "moderationType": "FlagAsInappropriate",
- "note": "string",
- "visibility": "ModeratorsOnly"
}
], - "nextPageToken": "string",
- "nextPageUrl": "string",
- "pageSize": 0
}
}Moderation Flags on Files
Delete all flags on a file.
Available in: v36.0
Note: In versions 30.0–35.0, use /connect/communities/{communityId}/chatter/files/{fileId}/moderation-flags.
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
| fileId required | string <Id> ^(069)\w* ID of a file. |
query Parameters
| userId | string The ID of the context user. If specified, removes the flag the user previously added to the file. If not specified and the context user is a moderator, removes all flags on the file. Available in: v30.0 |
Responses
Get a list of assigned audiences that match the user context. Get audience information for a batch of audience IDs. Create, get, update, and delete an audience. Get a list of targets that match the user context, based on the assigned audiences that include the user. Create and update targets. Get target information for a batch of target IDs. Get and delete a target.
Note: Personalization varies what the user can see in the browser but doesn’t secure data in any way. To prevent users accessing sensitive data, use standard Salesforce security features, such as sharing rules and permission sets.
Personalization Audiences
Get a list of assigned audiences that match the user context.
Available in: v47.0
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
query Parameters
| domain | string Name of the user’s Salesforce custom domain. If not specified, no audiences with domain criteria are returned. Available in: v47.0 |
| includeAudienceCriteria | boolean Specifies whether to include audience
criteria ( Available in: v47.0 |
| ipAddress | string IP address of the user. If not specified, no audiences with location criteria are returned. Available in: v47.0 |
| publishStatus | string (ConnectPublishStatusEnum) Enum: "Draft" "Live" Publish status of the audience. If not specified, the default is Available in: v47.0 |
| recordId | string ID of the record for field based criteria. If not specified, all applicable audiences with field based criteria are returned. Available in: v51.0 |
| targetTypes | Array of strings Comma-separated list of target types to filter the results. Supported values include:
If not specified, all target types are returned. Available in: v47.0 |
| userId | string ID of the user. If not specified, the default is the ID of the context user. Available in: v47.0 |
Responses
Response samples
- 200
{- "audiences": [
- {
- "criteria": [
- {
- "criterion": [
- {
- "value": {
- "property1": "string",
- "property2": "string"
}
}
], - "criterionNumber": 0,
- "criterionOperator": "Contains",
- "criterionType": "Audience"
}
], - "customFormula": "string",
- "formulaFilterType": "AllCriteriaMatch",
- "id": "string",
- "name": "string",
- "targets": [
- {
- "formulaScope": {
- "contextValuesMap": {
- "property1": { },
- "property2": { }
}, - "fields": [
- "string"
], - "formula": "string",
- "contextValues": {
- "property1": "string",
- "property2": "string"
}
}, - "groupName": "string",
- "id": "string",
- "isMatch": true,
- "priority": 0,
- "publishStatus": "Draft",
- "targetType": "string",
- "targetValue": "string",
- "url": "string"
}
], - "url": "string"
}
]
}Personalization Audiences
Create an audience.
Available in: v47.0
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
Request Body schema: application/json
An audience.
Array of objects (AudienceCriterionInput) List of audience criteria to update or add. An audience can have up to 100 criteria. Required when creating an audience. Optional when updating an audience Available in: v47.0 | |
| customFormula | string Custom formula for the audience criteria. For example, (1 AND 2) OR 3. Required when creating an audience with the Available in: v47.0 |
| formulaFilterType | string (FormulaFilterTypeEnum) Enum: "AllCriteriaMatch" "AnyCriterionMatches" "CustomLogicMatches" Formula filter type for the personalization audience. Values are:
Required when creating an audience. Optional when updating an audience Available in: v47.0 |
| name | string Name of the audience. Required when creating an audience. Optional when updating an audience Available in: v47.0 |
Responses
Request samples
- Payload
- Example 1
{- "criteria": [
- {
- "criterion": [
- {
- "audienceId": "string",
- "city": "string",
- "country": "string",
- "domainId": "string",
- "entityField": "string",
- "entityType": "string",
- "fieldValue": "string",
- "isEnabled": true,
- "permission": "string",
- "profileId": "string",
- "subdivision": "string"
}
], - "criterionNumber": 0,
- "criterionOperator": "Contains",
- "criterionType": "Audience"
}
], - "customFormula": "string",
- "formulaFilterType": "AllCriteriaMatch",
- "name": "string"
}Response samples
- 200
{- "criteria": [
- {
- "criterion": [
- {
- "value": {
- "property1": "string",
- "property2": "string"
}
}
], - "criterionNumber": 0,
- "criterionOperator": "Contains",
- "criterionType": "Audience"
}
], - "customFormula": "string",
- "formulaFilterType": "AllCriteriaMatch",
- "id": "string",
- "name": "string",
- "targets": [
- {
- "formulaScope": {
- "contextValuesMap": {
- "property1": { },
- "property2": { }
}, - "fields": [
- "string"
], - "formula": "string",
- "contextValues": {
- "property1": "string",
- "property2": "string"
}
}, - "groupName": "string",
- "id": "string",
- "isMatch": true,
- "priority": 0,
- "publishStatus": "Draft",
- "targetType": "string",
- "targetValue": "string",
- "url": "string"
}
], - "url": "string"
}Personalization Audiences, Batch
Get audience information for a comma-separated list of audience IDs.
Available in: v48.0
path Parameters
| audienceIds required | Array of strings <Id> [ items <Id > ] Comma-separated list of audience IDs. |
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
Responses
Response samples
- 200
{- "hasErrors": true,
- "results": [
- {
- "result": null,
- "statusCode": 0
}
]
}Personalization Audience
Get an audience.
Available in: v47.0
path Parameters
| audienceId required | string <Id> ^(6Au)\w* ID of the audience. |
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
query Parameters
| includeAudienceCriteria | boolean Specifies whether to include audience
criteria ( Available in: v47.0 |
Responses
Response samples
- 200
{- "criteria": [
- {
- "criterion": [
- {
- "value": {
- "property1": "string",
- "property2": "string"
}
}
], - "criterionNumber": 0,
- "criterionOperator": "Contains",
- "criterionType": "Audience"
}
], - "customFormula": "string",
- "formulaFilterType": "AllCriteriaMatch",
- "id": "string",
- "name": "string",
- "targets": [
- {
- "formulaScope": {
- "contextValuesMap": {
- "property1": { },
- "property2": { }
}, - "fields": [
- "string"
], - "formula": "string",
- "contextValues": {
- "property1": "string",
- "property2": "string"
}
}, - "groupName": "string",
- "id": "string",
- "isMatch": true,
- "priority": 0,
- "publishStatus": "Draft",
- "targetType": "string",
- "targetValue": "string",
- "url": "string"
}
], - "url": "string"
}Personalization Audience
Update an audience.
Available in: v47.0
path Parameters
| audienceId required | string <Id> ^(6Au)\w* ID of the audience. |
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
Request Body schema: application/json
An audience.
Array of objects (AudienceCriterionInput) List of audience criteria to update or add. An audience can have up to 100 criteria. Required when creating an audience. Optional when updating an audience Available in: v47.0 | |
| customFormula | string Custom formula for the audience criteria. For example, (1 AND 2) OR 3. Required when creating an audience with the Available in: v47.0 |
| formulaFilterType | string (FormulaFilterTypeEnum) Enum: "AllCriteriaMatch" "AnyCriterionMatches" "CustomLogicMatches" Formula filter type for the personalization audience. Values are:
Required when creating an audience. Optional when updating an audience Available in: v47.0 |
| name | string Name of the audience. Required when creating an audience. Optional when updating an audience Available in: v47.0 |
Responses
Request samples
- Payload
- Example 1
{- "criteria": [
- {
- "criterion": [
- {
- "audienceId": "string",
- "city": "string",
- "country": "string",
- "domainId": "string",
- "entityField": "string",
- "entityType": "string",
- "fieldValue": "string",
- "isEnabled": true,
- "permission": "string",
- "profileId": "string",
- "subdivision": "string"
}
], - "criterionNumber": 0,
- "criterionOperator": "Contains",
- "criterionType": "Audience"
}
], - "customFormula": "string",
- "formulaFilterType": "AllCriteriaMatch",
- "name": "string"
}Response samples
- 200
{- "criteria": [
- {
- "criterion": [
- {
- "value": {
- "property1": "string",
- "property2": "string"
}
}
], - "criterionNumber": 0,
- "criterionOperator": "Contains",
- "criterionType": "Audience"
}
], - "customFormula": "string",
- "formulaFilterType": "AllCriteriaMatch",
- "id": "string",
- "name": "string",
- "targets": [
- {
- "formulaScope": {
- "contextValuesMap": {
- "property1": { },
- "property2": { }
}, - "fields": [
- "string"
], - "formula": "string",
- "contextValues": {
- "property1": "string",
- "property2": "string"
}
}, - "groupName": "string",
- "id": "string",
- "isMatch": true,
- "priority": 0,
- "publishStatus": "Draft",
- "targetType": "string",
- "targetValue": "string",
- "url": "string"
}
], - "url": "string"
}Personalization Targets
Get a list of targets that match the user context, based on the assigned audiences that include the user.
Available in: v47.0
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
query Parameters
| domain | string Name of the user’s Salesforce custom domain. If not specified, no audience targets with domain criteria are returned. Available in: v47.0 |
| groupNames | Array of strings A comma-separated list of group names. Groups bundle
related target and audience pairs. If you’re specifying group names, you must also specify a single Available in: v48.0 |
| includeAllMatchingTargetsWithinGroup | boolean Specifies whether to include all the matching targets within a target group ( Available in: v47.0 |
| includeAudience | boolean Specifies whether to include the matching audience ( Available in: v47.0 |
| ipAddress | string IP address of the user. If not specified, no audience targets with location criteria are returned. Available in: v47.0 |
| publishStatus | string (ConnectPublishStatusEnum) Enum: "Draft" "Live" Publish status of the target. If not specified, the default is Available in: v47.0 |
| recordId | string ID of the record, if you want to specify field based criteria in audiences. Available in: v47.0 |
| targetTypes | Array of strings Comma-separated list of target types to filter the results. Supported values include:
If not specified, all target types are returned. Required if specifying Available in: v47.0 |
| userId | string ID of the user. If not specified, the default is the ID of the context user. Available in: v47.0 |
Responses
Response samples
- 200
{- "targets": [
- {
- "audience": {
- "audienceName": "string",
- "id": "string",
- "url": "string"
}, - "formulaScope": {
- "contextValuesMap": {
- "property1": { },
- "property2": { }
}, - "fields": [
- "string"
], - "formula": "string",
- "contextValues": {
- "property1": "string",
- "property2": "string"
}
}, - "groupName": "string",
- "id": "string",
- "priority": 0,
- "publishStatus": "Draft",
- "targetType": "string",
- "targetValue": "string",
- "url": "string",
- "scope": [
- {
- "name": "string",
- "value": "string"
}
]
}
]
}Personalization Targets
Create targets.
Available in: v47.0
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
Request Body schema: application/json
required | Array of objects (TargetInput) List of targets to create. Available in: v47.0 |
Responses
Request samples
- Payload
{- "targets": [
- {
- "audienceId": "6AuRM0000004D5w0AE",
- "groupName": "2b8bc305-d415-49f9-8e24-814455427324",
- "priority": 1,
- "publishStatus": "Draft",
- "targetType": "ExperienceVariation",
- "targetValue": "ContactSupport_ContactSupportForCalifornia_Page"
}
]
}Response samples
- 200
{- "targets": [
- {
- "audience": {
- "audienceName": "string",
- "id": "string",
- "url": "string"
}, - "formulaScope": {
- "contextValuesMap": {
- "property1": { },
- "property2": { }
}, - "fields": [
- "string"
], - "formula": "string",
- "contextValues": {
- "property1": "string",
- "property2": "string"
}
}, - "groupName": "string",
- "id": "string",
- "priority": 0,
- "publishStatus": "Draft",
- "targetType": "string",
- "targetValue": "string",
- "url": "string",
- "scope": [
- {
- "name": "string",
- "value": "string"
}
]
}
]
}Personalization Targets
Update targets.
Available in: v47.0
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
Request Body schema: application/json
required | Array of objects (TargetUpdateInput) List of targets to update. Available in: v47.0 |
Responses
Request samples
- Payload
{- "targets": [
- {
- "audienceId": "6AuRM0000004D5w0AE",
- "priority": 1,
- "targetId": "6AtRM0000000II30AM"
}
]
}Response samples
- 200
{- "targets": [
- {
- "audience": {
- "audienceName": "string",
- "id": "string",
- "url": "string"
}, - "formulaScope": {
- "contextValuesMap": {
- "property1": { },
- "property2": { }
}, - "fields": [
- "string"
], - "formula": "string",
- "contextValues": {
- "property1": "string",
- "property2": "string"
}
}, - "groupName": "string",
- "id": "string",
- "priority": 0,
- "publishStatus": "Draft",
- "targetType": "string",
- "targetValue": "string",
- "url": "string",
- "scope": [
- {
- "name": "string",
- "value": "string"
}
]
}
]
}Personalization Targets, Batch
Get target information for a comma-separated list of target IDs.
Available in: v47.0
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
| targetIds required | Array of strings <Id> [ items <Id > ] Comma-separated list of target IDs. |
Responses
Response samples
- 200
{- "hasErrors": true,
- "results": [
- {
- "result": null,
- "statusCode": 0
}
]
}Personalization Target
Get a target.
Available in: v47.0
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
| targetId required | string <Id> ^(6At)\w* ID of the target. |
Responses
Response samples
- 200
{- "audience": {
- "audienceName": "string",
- "id": "string",
- "url": "string"
}, - "formulaScope": {
- "contextValuesMap": {
- "property1": { },
- "property2": { }
}, - "fields": [
- "string"
], - "formula": "string",
- "contextValues": {
- "property1": "string",
- "property2": "string"
}
}, - "groupName": "string",
- "id": "string",
- "priority": 0,
- "publishStatus": "Draft",
- "targetType": "string",
- "targetValue": "string",
- "url": "string",
- "scope": [
- {
- "name": "string",
- "value": "string"
}
]
}Get information about Experience Cloud sites, create a site, and publish a site. Get the Experience Builder templates available to the context user. Get externally managed accounts for sites.
Experience Cloud Sites List
Get a list of all Experience Cloud sites available to the context user.
Available in: v28.0
query Parameters
| status | string (ConnectNetworkStatusEnum) Enum: "Inactive" "Live" "UnderConstruction" Returns only sites with the specified status. Only users with the Manage Experiences permission can see sites with
an Available in: v28.0 |
Responses
Response samples
- 200
{- "communities": [
- {
- "allowChatterAccessWithoutLogin": true,
- "allowMembersToFlag": true,
- "builderBasedSnaEnabled": true,
- "builderUrl": "string",
- "contentSpaceId": "string",
- "description": "string",
- "guestMemberVisibilityEnabled": true,
- "id": "string",
- "imageOptimizationCDNEnabled": true,
- "invitationsEnabled": true,
- "knowledgeableEnabled": true,
- "loginUrl": "string",
- "memberVisibilityEnabled": true,
- "name": "string",
- "nicknameDisplayEnabled": true,
- "privateMessagesEnabled": true,
- "reputationEnabled": true,
- "sendWelcomeEmail": true,
- "siteAsContainerEnabled": true,
- "siteUrl": "string",
- "status": "Inactive",
- "templateName": "string",
- "url": "string",
- "urlPathPrefix": "string"
}
], - "total": 0
}Experience Cloud Sites List
Create an Experience Cloud site.
Available in: v46.0
Request Body schema: application/json
| description | string Description of the site. Available in: v46.0 |
| name required | string Name of the site. Available in: v46.0 |
| templateName required | string Name of the Experience Builder template for the site. Use the Experience Builder Templates resource to get a list of available templates and their names. Available in: v46.0 |
object Map of template-specific parameters. Valid values are:
The Available in: v52.0 | |
| urlPathPrefix | string URL prefix for the site. For example, in the site URL Required if you already have a site that doesn't have a Available in: v46.0 |
Responses
Request samples
- Payload
{- "name": "The Capricorn Cafe",
- "urlPathPrefix": "capricorncafe",
- "templateName": "B2B Commerce Template",
- "templateParams": {
- "CreateStoreDefaults": "ALL"
}, - "description": "Coffee and coffee products for the most discerning tastes."
}Response samples
- 200
{- "jobId": "string",
- "message": "string",
- "name": "string"
}Experience Cloud Site
Get information about an Experience Cloud site.
Available in: v26.0
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
Responses
Response samples
- 200
{- "allowChatterAccessWithoutLogin": true,
- "allowMembersToFlag": true,
- "builderBasedSnaEnabled": true,
- "builderUrl": "string",
- "contentSpaceId": "string",
- "description": "string",
- "guestMemberVisibilityEnabled": true,
- "id": "string",
- "imageOptimizationCDNEnabled": true,
- "invitationsEnabled": true,
- "knowledgeableEnabled": true,
- "loginUrl": "string",
- "memberVisibilityEnabled": true,
- "name": "string",
- "nicknameDisplayEnabled": true,
- "privateMessagesEnabled": true,
- "reputationEnabled": true,
- "sendWelcomeEmail": true,
- "siteAsContainerEnabled": true,
- "siteUrl": "string",
- "status": "Inactive",
- "templateName": "string",
- "url": "string",
- "urlPathPrefix": "string"
}Experience Cloud Site Preview URL
Get a preview URL for an Experience Cloud site page.
Available in: v61.0
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
| pageApiName required | string The |
query Parameters
| urlParameters | string URL-encoded string of key-value pairs, such as Optional unless required by the page URL Available in: v61.0 |
Responses
Response samples
- 200
{- "previewUrl": "string"
}Experience Cloud Site, Publish
Publish an Experience Cloud site.
Available in: v46.0
Note: POST doesn’t take request parameters or a request body.
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. |
Responses
Response samples
- 200
{- "id": "string",
- "jobId": "string",
- "message": "string",
- "name": "string",
- "url": "string"
}Experience Cloud Sites Externally Managed Accounts
Get externally managed accounts available to the context user across all Experience Cloud sites.
Available in: v50.0
path Parameters
| communityId required | string <CommunityId> ID of an Experience Cloud site. Regardless of the ID specified, this resource returns all the externally managed accounts available to the context user across all sites. |
query Parameters
| includeMyAccount | boolean Specifies whether to return the context user’s account
( Available in: v53.0 |
Responses
Response samples
- 200
{- "externalManagedAccounts": [
- {
- "accountId": "string",
- "accountName": "string",
- "address": {
- "city": "string",
- "country": "string",
- "geolocationAccuracy": "string",
- "latitude": "string",
- "longitude": "string",
- "state": "string",
- "street": "string",
- "zip": "string"
}, - "externalManagedAccountId": "string",
- "isMyAccount": true
}
], - "totalExternalManagedAccounts": 0
}