Get Channels

Fetches the social media channels connected to a brand. Returns channels in active or reconnect state. User must have access (all or limited channels) to the brand.

Request URL

https://{api_domain}/social/v2/channels

Scope

ZohoSocial.Integration.READCopied!

Request Parameters

- Request Headers

portal_idstringMandatory

12345678Copied!

Unique identifier for your Zoho Social portal. Use Get Portals to retrieve your portal ID.

brand_idstringMandatory

10001000000251005Copied!

Unique identifier for a brand within your portal. Use Get Brands to retrieve your brand ID.

- Query Parameters

fieldsstring(length <= 1000)Optional

Comma-separated list of fields to include in the response.
Example: fields=id,name,network,status

Maximum Length :1000Copied!

Response Parameters

- HTTP code 200

Response Body - application/json

JSON object

A list of connected channels for a brand.

Show Sub-Attributes

dataJSON array

List of social media channels connected to the brand.

Show Sub-Attributes

idstring

Unique channel ID in Zoho Social.

profile_idstring

Network-specific profile or page ID.

namestring

Display name of the channel.

networkstring

Unique identifier for the social network. Refer here for more details.

Allowed Values :

Show Values ▾

image_urluri

Profile Image URL of the channel.

statusstring

Channel connection status.

token_active: The channel is properly connected and authenticated.
token_reconnect: The channel needs to be re-authenticated.
channel_deletion: The channel is being deleted by Zoho Social.
access_denied: The app's access to the channel has been revoked on the network side.

Allowed Values :

Show Values ▾

specificationJSON object

Network-specific media limits for the channel. Only present for certain networks (e.g. Mastodon).

Show Sub-Attributes

video_matrix_limitstring

Maximum video pixel count (width x height).

video_frame_rate_limitstring

Maximum video frame rate.

max_charactersinteger

Maximum character count for posts.

image_size_limitstring

Maximum image file size in bytes.

image_matrix_limitstring

Maximum image pixel count (width x height).

video_size_limitstring

Maximum video file size in bytes.

is_verifiedboolean

Whether the channel is verified on the network.

Possible Response Codes

200HTTP code

Returns the list of connected channels for the brand.

Endpoints

get /social/v2/channels

Copy full URL

Sample Request

Curl

Copied!

curl --request GET \
  --url 'https://{api_domain}/social/v2/channels?fields=id,name,network,status' \
  --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'

▼ Show full

Sample Response: HTTP 200

Copied!

  {
    "data": [
      {
        "profile_id": "199261460688447",
        "image_url": "https://scontent.fmaa12-3.fna.fbcdn.net/v/t39.30808-1/309383747_408665228090510_3043176412028930284_n.png?stp=cp0_dst-png_s50x50&_nc_cat=100&ccb=1-7&_nc_sid=f907e8&_nc_ohc=uLFJ2hdINeEQ7kNvwGCJpw0&_nc_oc=AdoXL9EigOVhOzFifXLpOCoIUKWmybbilcMlsEgUThXaMdRapAZVfpu5785ATGlPNrM&_nc_zt=24&_nc_ht=scontent.fmaa12-3.fna&edm=AJdBtusEAAAA&_nc_gid=cJLtDFKB0KUxuuRSIE6h-g&_nc_tpa=Q5bMBQGZZGDkha5nxkA4hgBHRsuO2-RsJp4GbBwgZcAk-uoXYgpUQcLf_nSQe4rT0Mq1Su0PzZosoQd5&oh=00_Af7JuW4IOAngmzEfWClO-BBen9c1shWwnYYjYVrLQkEveA&oe=6A074BA8",
        "name": "Ask",
        "id": "37715000000251029",
        "is_verified": true,
        "network": "facebookpage",
        "status": "token_active"
      },
      {
        "profile_id": "994452510298464257",
        "image_url": "https://abs.twimg.com/sticky/default_profile_images/default_profile_normal.png",
        "name": "@askOwntest",
        "id": "37715000000313047",
        "is_verified": true,
        "network": "twitter",
        "status": "token_active"
      },
      {
        "profile_id": "vjjy8EFbNN",
        "image_url": "https://media.licdn.com/dms/image/v2/C5103AQFKUcwatk-bmg/profile-displayphoto-shrink_400_400/profile-displayphoto-shrink_400_400/0/1517272823617?e=1779926400&v=beta&t=LeriQCL5_gQhF-pKsD6h7EmQPxnRCriWZ5YX9ZodMEM",
        "name": "Jack Smith",
        "id": "37715000007082045",
        "is_verified": true,
        "network": "linkedinprofile",
        "status": "token_active"
      },
      {
        "profile_id": "13738763",
        "image_url": "https://media.licdn.com/dms/image/v2/C560BAQEjniN1vISCWA/company-logo_400_400/company-logo_400_400/0/1630658290904/askanode_logo?e=1779926400&v=beta&t=-DhUDh3isSZiUxXBpumsvWXYeXRt5XApN45tVN1nGbw",
        "name": "askanode",
        "id": "37715000005752037",
        "is_verified": true,
        "network": "linkedinpage",
        "status": "token_active"
      },
      {
        "profile_id": "17841424201770412",
        "image_url": "https://scontent.cdninstagram.com/v/t51.2885-19/90229722_1708406005978909_2034855230243340288_n.jpg?stp=dst-jpg_s206x206_tt6&_nc_cat=100&ccb=7-5&_nc_sid=bf7eb4&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=UW64DJ1IPqIQ7kNvwERhkcu&_nc_oc=AdqpqQCaQqcA9YvcsNx3IfqISKPo8tQIlFw5NmQQ_Fa3lz-C9qJkWPtgFHAE5mDyidc&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&edm=AP4hL3IEAAAA&_nc_tpa=Q5bMBQHDXfmlNpTz8KkgPNozzYTd-1g_E1kCsMCHv6F5Hfl_pJ5D4nRp-J6qAgS5VHRqK4pLoU-Pr52H&oh=00_Af7nIzabHcgWTXfrIRiLeTynYOs8ne_RBiXZ6sBA7iF6JQ&oe=6A025812",
        "name": "askowntest",
        "id": "37715000010437007",
        "is_verified": true,
        "network": "instagram",
        "status": "token_active"
      },
      {
        "profile_id": "12100907769793650112",
        "image_url": "https://static.zohocdn.com/social/images/zsc-gmb-location.e9a8eb348723e66fb47929ce9547c9f2.png",
        "name": "Zylker Travels",
        "id": "37715000010398065",
        "is_verified": true,
        "network": "googlemybusiness",
        "status": "token_active"
      },
      {
        "profile_id": "UC1ufuY-wlICSOe4MmEFEBSw",
        "image_url": "https://yt3.ggpht.com/ytc/AIdro_m6eq7337RSmF2Wu_NkoiEDUTVJcXFO57nR3UIIlHo=s88-c-k-c0x00ffffff-no-rj",
        "name": "Anode Creation",
        "id": "37715000002296095",
        "is_verified": false,
        "network": "youtube",
        "status": "token_active"
      },
      {
        "profile_id": "anode1997",
        "image_url": "https://i.pinimg.com/600x600_R/24/6e/24/246e24e04d031c228537a0e524f3da3b.jpg",
        "name": "anode1997",
        "id": "37715000010441005",
        "is_verified": true,
        "network": "pinterest",
        "status": "token_active"
      },
      {
        "profile_id": "112116141284220295",
        "image_url": "https://mastodon.social/avatars/original/missing.png",
        "name": "anodeask",
        "specification": {
          "video_matrix_limit": "8294400",
          "video_frame_rate_limit": "120",
          "max_characters": 500,
          "image_size_limit": "16777216",
          "image_matrix_limit": "33177600",
          "video_size_limit": "103809024"
        },
        "id": "37715000007868259",
        "is_verified": true,
        "network": "mastodon",
        "status": "token_active"
      },
      {
        "profile_id": "9553494478021918",
        "image_url": "https://scontent.cdninstagram.com/v/t51.2885-19/451413484_1071343117794423_654207941354737810_n.jpg?stp=dst-jpg_s206x206_tt6&_nc_cat=109&ccb=7-5&_nc_sid=30ff31&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=MudPKn9SPlkQ7kNvwEjTC6Y&_nc_oc=Adr2OeWni6q17T7wbKgnxNqml7LdcSLvMhdXZ7vSQQCrvQi2Bo7dZp0Cq__GKtRE0ok&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&edm=AP4hL3IEAAAA&_nc_tpa=Q5bMBQFZJfxdF4OFy3eHiATXVLqk_v6a5uOoJlfJRIdTdnSXt21qMNzIz9b6cSY2isNVG8qJEMN1IQB6&oh=00_Af7cTwGdTBZiNOaJW_1SA4-xtIIeWxLFc5_e7JWuTSUTBQ&oe=6A024974",
        "name": "askowntest",
        "id": "37715000010302009",
        "is_verified": true,
        "network": "threadsbyig",
        "status": "token_reconnect"
      },
      {
        "profile_id": "did:plc:5nvq73jjg25bvy3oqhyy7dnj",
        "image_url": "https://cdn.bsky.app/img/avatar/plain/did:plc:5nvq73jjg25bvy3oqhyy7dnj/bafkreicnkvjwh2xtbsjh4w4zukv7q3x2vxemrtaqt3sv4sj5gqh3lelcfu",
        "name": "askanode.bsky.social",
        "id": "37715000007780151",
        "is_verified": true,
        "network": "bluesky",
        "status": "token_reconnect"
      }
    ]
  }

▼ Show full