Channels

Channels Endpoint

The Channels Endpoint allows users to retrieve a list of their integrated social media accounts linked with MarketingBlocks. This endpoint is designed to manage and organize users' marketing content across different platforms efficiently.

When accessed, it returns detailed information regarding each connected channel, including the platform type, account name, and integration status.

⚠️ Permission Requirement: This endpoint requires the social-read-channels permission on the API token to function.

Ideal for marketers aiming to streamline their social media campaigns through a single interface.

Get Channels

get

Query parameters

typesstringOptionalExample: facebook,instagram,twitter,tiktok,youtube,linkedin

limitintegerOptionalExample: 10

Responses

200

Response

application/json

get

/api/v1/social-sparks/channels

HTTPcURLJavaScriptPython

GET /api/v1/social-sparks/channels HTTP/1.1
Host: app.marketingblocks.ai
Accept: */*

200

Response

{
  "channels": {
    "current_page": 1,
    "data": [
      {
        "channel_id": 1,
        "platform": "text",
        "account_name": "text",
        "avatar": "https://example.com"
      }
    ],
    "first_page_url": "https://example.com",
    "from": 1,
    "last_page": 1,
    "last_page_url": "https://example.com",
    "next_page_url": null,
    "path": "https://example.com",
    "per_page": 1,
    "prev_page_url": null,
    "to": 1,
    "total": 1
  },
  "status": true
}