Connect REST API Developer Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
Connect REST API Developer Guide
Introduction
Quick Start
Work with Features
Examples
Resources
Action Links Resources
Activity Reminders Resources
Application for Program
Batch Resource
Bot Version Activation Resource
Briefcase Priming Records Resource
Call Coaching Resources
Clean Resources
CMS Managed Content Resources
Commerce B2B and D2C Resources
Commerce Einstein Webstore Resources
Connect Resources
Content Taxonomy Resources
Content Workspace Permissions Resource
Conversation Application Definition Resource
Conversations Resources
Custom Domain Resources
Customer Asset Lifecycle Management Resources
Data Cloud Resources
Data Integration Resources
Duplicate Resources
Einstein Prediction Service Resources
Prompt Templates Resources
Einstein Recommendation Resources
Email Merge Field Services Resource
Employee Profiles Resources
Enhanced CMS Workspaces Resources
Environment Hub Resources
Experience Cloud CMS Content Search Resource
Experience Cloud Microsites Resources
Experience Cloud Sites Knowledge Resources
Experience Cloud Sites Moderation Resources
Experience Cloud Sites Resources
Experience Model Resources
External Email Services Resource
Field Service Recordset Filter Criteria Resource
Field Service Shifts from Pattern Resource
Files Connect Repository Resources
Files Resources
Folders Resources
Forecasts Resources
Knowledge Article View Stat Resource
List Share Resources
Managed Topics Resources
Messaging Channels Resource
Microbatching Resources
Motifs Resources
Named Credentials Resources
Navigation Menu Items Resource
Network Data Category Resources
Next Best Action Resources
Notification Settings Resources
Notifications Resources
OAuth Credentials Resources
OAuth Usage Resources
Orchestration Resources
Pardot Business Unit Context Resource
Personalization Resources
Private Connect Resources
Push Notifications Resource
Quick Text Resource
Quip Related Records Resource
Salesforce Omnichannel Inventory Resources
Salesforce Order Management Resources
Salesforce Payments Resources
Salesforce Scheduler Resources
Search Resources
Share Captured Activity Resource
Social Engagement Resources
Social Engagement Setup Resources
Social Engagement Setup
Social Engagement Setup Configuration
Managed Social Accounts Setup Authentication
Managed Social Accounts Setup
Managed Social Account Setup
Social Engagement Terms of Service
Surveys Resources
Topics Resources
Topics on Records Resource
Type System Resources
User Files Resources
Voice Resources
Chatter Resources
Request Bodies
Response Bodies
Appendices
PDF

Managed Social Accounts Setup

Add managed social accounts and get managed social accounts from a recently authenticated social network.
Resource
/connect/social-engagement/setup/managed-social-accounts
Available version
44.0
HTTP methods
GET, POST
Request parameters for GET
Parameter Name Type Description Required or Optional Available Version
managedAccountId String ID that Social Studio provides after the user authenticates to a social network. If you provide this parameter, we make a request to the Social Studio to find out what managed accounts are available to that social network user. For example, this parameter can be used to get fan pages managed by a Facebook user. Optional 44.0
Request body for POST
Root XML tag
<managedSocialAccountSetup>
JSON example
{ 
  "managedAccountId" : "exampleSocialStudioId",
  "socialNetwork" : "Facebook",
  "parentProviderUserId" : "exampleFacebookUserId",
  "providerUserId" : "exampleFacebookFanpageId",
  "status" : "Running"
}
Properties
Name Type Description Required or Optional Available Version
managedAccountId String ID for this managed account in a third-party system (for example, Social Studio). Required 44.0
parentProvider​UserId String User ID of the user on the social network if the managed social account is a fan page (for example, a Facebook fan page). Required when using Facebook for POST requests to /connect/social-​engagement/setup​/managed-social-​accounts. Otherwise it is optional. 44.0
providerUserId String User ID of the user on the social network, or the Page ID of the page if the managed social account is a fan page. Required for POST requests to /connect/social-​engagement/setup/​managed-social-​accounts. Optional for PATCH requests to /connect/social-​engagement/setup/​managed-social-​accounts/id. 44.0
socialNetwork String Social network that this account belongs to. Values are:
  • Facebook
  • Twitter
  • Instagram (if your org supports it)
  • YouTube (if your org supports it)
To see which networks are available on your org, check with your Salesforce representative.		 Required for POST requests to /connect/social-​engagement/setup/​managed-social-​accounts. Optional for PATCH requests to /connect/social-​engagement/setup/​managed-social-​accounts/id. 44.0
status String
Status of this managed social account. Values are:
  • Running—Posts for this social account are being sent to your org.
  • Stopped—Posts for this social account aren’t being sent to your org.
Use this field to start and stop inbound activity for a given social account. Defaults to Running for a Social Customer Service Starter/Pro tenant; defaults to Stopped for a Full Social Studio tenant.		 Optional 44.0
Response body for GET
Managed Social Accounts Setup
Response body for POST
Managed Social Account Setup