Managed Social Account Setup

Manage a social account.
Resource
/connect/social-engagement/setup/managed-social-accounts/id
Available version
44.0
HTTP methods
GET, PATCH, DELETE
Request body for PATCH
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 and PATCH
Managed Social Account Setup
Response for DELETE
204: Successful Delete