Skip to main content
GET
/
v1
/
integration
/
list
curl -X GET "https://api.hooked.so/v1/integration/list" \
  -H "x-api-key: your_api_key_here"

{
  "success": true,
  "message": "Integrations fetched successfully",
  "data": {
    "integrations": [
      {
        "id": "int_yt_abc123",
        "type": "youtube",
        "identifier": "UC1234567890",
        "account": {
          "id": "UC1234567890",
          "name": "My YouTube Channel",
          "username": "mychannel",
          "avatarUrl": "https://yt3.ggpht.com/..."
        }
      },
      {
        "id": "int_tt_xyz789",
        "type": "tiktok",
        "identifier": "@myaccount",
        "account": {
          "id": "6912345678901234567",
          "name": "My TikTok",
          "username": "myaccount",
          "avatarUrl": "https://p16-sign.tiktokcdn.com/..."
        }
      },
      {
        "id": "int_ig_def456",
        "type": "instagram",
        "identifier": "myinstagram",
        "account": {
          "id": "12345678901234567",
          "name": "My Instagram",
          "username": "myinstagram",
          "avatarUrl": "https://instagram.com/..."
        }
      }
    ],
    "total": 3
  }
}
Try it out! Use the API playground on the right to test the List Integrations endpoint directly.

​
Overview

List all social media integrations connected to your account. These integrations are used to schedule and publish videos to platforms like YouTube, TikTok, and Instagram. Before scheduling a video, you need to connect at least one social platform through the Hooked dashboard.
Integrations are configured in your Hooked Dashboard. Each integration represents a connected social media account.

​
Endpoint

GET /v1/integration/list

​
Headers

​
x-api-key
string
required
Your API key from API Settings

​
Response

​
success
boolean
Whether the request was successful
​
message
string
Status message
​
data
object

​
Request Example

curl -X GET "https://api.hooked.so/v1/integration/list" \
  -H "x-api-key: your_api_key_here"

​
Response Examples

{
  "success": true,
  "message": "Integrations fetched successfully",
  "data": {
    "integrations": [
      {
        "id": "int_yt_abc123",
        "type": "youtube",
        "identifier": "UC1234567890",
        "account": {
          "id": "UC1234567890",
          "name": "My YouTube Channel",
          "username": "mychannel",
          "avatarUrl": "https://yt3.ggpht.com/..."
        }
      },
      {
        "id": "int_tt_xyz789",
        "type": "tiktok",
        "identifier": "@myaccount",
        "account": {
          "id": "6912345678901234567",
          "name": "My TikTok",
          "username": "myaccount",
          "avatarUrl": "https://p16-sign.tiktokcdn.com/..."
        }
      },
      {
        "id": "int_ig_def456",
        "type": "instagram",
        "identifier": "myinstagram",
        "account": {
          "id": "12345678901234567",
          "name": "My Instagram",
          "username": "myinstagram",
          "avatarUrl": "https://instagram.com/..."
        }
      }
    ],
    "total": 3
  }
}

​
Supported Platforms

PlatformTypeFeatures
YouTubeyoutubeShorts, Long-form videos, Privacy settings
TikToktiktokShort videos, Direct publishing
InstagraminstagramReels, Posts, Stories

​
Connecting Integrations

To connect a new social platform:
  1. Go to Hooked Dashboard
  2. Navigate to Settings > Integrations
  3. Click Connect on the platform you want to add
  4. Complete the OAuth authorization flow
Each platform has specific requirements:
  • YouTube: Requires a YouTube channel with uploads enabled
  • TikTok: Requires a TikTok Creator or Business account
  • Instagram: Requires an Instagram Business or Creator account connected to a Facebook Page

​
Next Steps

Schedule Video

Schedule a video for publishing

List Scheduled Posts

View all scheduled posts

Create Videos

Create videos to schedule

Webhooks Guide

Get notified when posts are published

Authorizations

​
x-api-key
string
header
required

Response

200 - application/json

Success

​
success
boolean
​
data
object