Skip to main content
GET
/
broadcast
/
v1
/
channels
/
setting
/
publish
/
current
Retrieve social channels connected to a HubSpot account
curl --request GET \
  --url https://api.hubapi.com/broadcast/v1/channels/setting/publish/current \
  --header 'Authorization: Bearer <token>'
[
  {
    "channelGuid": "57883b6f-88c7-3050-91ee-c99eb0749d59",
    "portalId": 62515,
    "channelId": "4654321",
    "accountGuid": "10056a5f-7a35-4653-bcce-13307286eca0",
    "createdAt": 1558129620104,
    "updatedAt": 1559643047214,
    "active": true,
    "shared": false,
    "channelKey": "Twitter:4654321",
    "hidden": false,
    "settings": {},
    "channelScopes": [],
    "type": "Twitter",
    "channelSlug": "twitter",
    "accountType": "Twitter",
    "accountSlug": "twitter",
    "username": "Twitter profile"
  },
  {
    "channelGuid": "385412d8-f1ea-39ff-9eb3-c2f1472c41e2",
    "portalId": 62515,
    "channelId": "1080012345608",
    "accountGuid": "31044074-81e8-493f-a315-bbc12153e229",
    "name": "Example Facebook page",
    "createdAt": 1556296960949,
    "updatedAt": 1559643041735,
    "active": true,
    "shared": true,
    "channelKey": "FacebookPage:1080012345608",
    "hidden": false,
    "settings": {},
    "channelScopes": [],
    "type": "FacebookPage",
    "displayName": "Example Facebook page",
    "dataMap": {
      "lastName": "User",
      "pageCategory": "Grocery Store",
      "pictureUrl": "https://scontent.xx.fbcdn.net/v/t1.0-1/c13.0.50.50a/p50x50/13912442_1080012345608_3326688728033556567_n.jpg?",
      "pageNameWithLocationDescriptor": "Example Facebook page",
      "fullName": "Example User",
      "pageId": "1080012345608",
      "userId": "101912106925069",
      "pageName": "Example Facebook page",
      "picture": "https://platform-lookaside.fbsbx.com/platform/profilepic/?asid=1016543219&height=50&width=50&ext=1562235036&hash=AeS_Mn51xJm2zq6U",
      "facebookPageTasks": "ANALYZE,ADVERTISE,MODERATE,CREATE_CONTENT,MANAGE",
      "firstName": "Example",
      "pageUsername": "examplefacebookpage"
    },
    "profileUrl": "https://www.facebook.com/1080012345608",
    "avatarUrl": "https://scontent.xx.fbcdn.net/v/t1.0-1/c13.0.50.50a/p50x50/13912442_1080012345608_3326688728033556567_n.jpg",
    "channelSlug": "facebookpage",
    "remoteUserIdForFeed": "Page:1080012345608",
    "accountType": "Facebook",
    "accountSlug": "facebook",
    "username": "Example Facebook page"
  }
]
Please note: the social media API is deprecated. While previous functionality is supported in a limited capacity, you should not use this API if you’re building a new app.

​
Required Scopes

This API requires one of the following scopes:
  • social

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Response

Channels retrieved successfully

​
channelGuid
string

Unique identifier for the channel provided by the social network

​
portalId
integer

ID of the HubSpot account

​
channelId
string

Unique identifier for the channel within HubSpot

​
createdAt
integer

Timestamp for when the channel was connected

​
updatedAt
integer

Timestamp for when the channel connection was last updated

​
active
boolean

Whether the channel is active and available to post to

​
shared
boolean

Whether the channel can be used by multiple HubSpot users

​
channelKey
string

A key that concatenates the network with the channelId

​
hidden
boolean

Whether the channel is hidden within HubSpot

​
settings
object

Any available settings provided by the social network

​
channelScopes
array

Scopes provided by the social network

​
channelSlug
string

A slug of the name of the social network (e.g., facebook)

​
accountType
string

The name of the social network (e.g., Facebook)

​
accountSlug
string

A slug of the social network (e.g., Facebook)

​
username
string

The username within the social network of the connected channel, if available