Get Integration Details - Hooked API Documentation

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

{
  "success": true,
  "data": {
    "id": "int_yt_abc123",
    "type": "youtube",
    "identifier": "UC1234567890",
    "account": {
      "id": "UC1234567890",
      "name": "My YouTube Channel",
      "username": "mychannel",
      "avatarUrl": "https://yt3.ggpht.com/..."
    },
    "health": {
      "status": "healthy",
      "tokenValid": true,
      "lastChecked": "2024-03-15T10:00:00.000Z"
    },
    "createdAt": "2024-01-15T08:30:00.000Z"
  }
}

GET

integration

{integrationId}

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

{
  "success": true,
  "data": {
    "id": "int_yt_abc123",
    "type": "youtube",
    "identifier": "UC1234567890",
    "account": {
      "id": "UC1234567890",
      "name": "My YouTube Channel",
      "username": "mychannel",
      "avatarUrl": "https://yt3.ggpht.com/..."
    },
    "health": {
      "status": "healthy",
      "tokenValid": true,
      "lastChecked": "2024-03-15T10:00:00.000Z"
    },
    "createdAt": "2024-01-15T08:30:00.000Z"
  }
}

Try it out! Use the API playground on the right to test the Get Integration Details endpoint directly.

Overview

Get detailed information about a specific connected social platform, including account details and connection health status. Use this to:

Verify if a connection is still valid before scheduling
Check if tokens have expired and need re-authentication
Get account details for display purposes

If the health status shows expired or error, the user needs to reconnect the account through the Hooked Dashboard.

Endpoint

GET /v1/integration/{integrationId}

Path Parameters

integrationId

string

required

The unique ID of the integration to retrieve

Headers

x-api-key

string

required

Your API key from API Settings

Response

success

boolean

Whether the request was successful

data

object

Show Integration Object

string

Unique integration ID

type

string

Platform type: youtube, tiktok, or instagram

identifier

string

Platform-specific identifier (channel ID, username, etc.)

account

object

Connected account information

Show Account Object

string

Platform account ID

name

string

Display name of the account

username

string

Username or handle

avatarUrl

string

Profile picture URL

health

object

Connection health status

Show Health Object

status

string

Health status:

healthy - Connection is working properly
expired - Token has expired, needs reconnection
error - Connection error, needs reconnection

tokenValid

boolean

Whether the access token is still valid

lastChecked

string

ISO 8601 timestamp of when health was checked

createdAt

string

When the integration was connected

Request Example

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

Response Examples

{
  "success": true,
  "data": {
    "id": "int_yt_abc123",
    "type": "youtube",
    "identifier": "UC1234567890",
    "account": {
      "id": "UC1234567890",
      "name": "My YouTube Channel",
      "username": "mychannel",
      "avatarUrl": "https://yt3.ggpht.com/..."
    },
    "health": {
      "status": "healthy",
      "tokenValid": true,
      "lastChecked": "2024-03-15T10:00:00.000Z"
    },
    "createdAt": "2024-01-15T08:30:00.000Z"
  }
}

Health Status Values

Status	Description	Action Required
`healthy`	Connection is working, token is valid	None
`expired`	Access token has expired	User must reconnect in dashboard
`error`	Connection error or missing token	User must reconnect in dashboard

Checking Health Before Scheduling

It’s a good practice to check integration health before scheduling a video:

async function scheduleIfHealthy(videoId, integrationId, scheduledDateTime) {
  // Check health first
  const healthResponse = await fetch(
    `https://api.hooked.so/v1/integration/${integrationId}`,
    { headers: { 'x-api-key': process.env.HOOKED_API_KEY } }
  );

  const { data: integration } = await healthResponse.json();

  if (integration.health.status !== 'healthy') {
    throw new Error(`Integration ${integration.type} needs reconnection`);
  }

  // Proceed with scheduling
  const scheduleResponse = await fetch(
    'https://api.hooked.so/v1/schedule/create',
    {
      method: 'POST',
      headers: {
        'x-api-key': process.env.HOOKED_API_KEY,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ videoId, integrationId, scheduledDateTime })
    }
  );

  return await scheduleResponse.json();
}

Next Steps

List Integrations

View all connected platforms

Disconnect

Remove a connected account

Schedule Video

Schedule a video for publishing

Dashboard

Reconnect accounts in dashboard

Authorizations

x-api-key

string

header

required

Path Parameters

integrationId

string

required

Integration ID

Response

200 - application/json

Success

success

boolean

data

object

Show child attributes

List Integrations Disconnect Integration

​Overview

​Endpoint

​Path Parameters

​Headers

​Response

​Request Example

​Response Examples

​Health Status Values

​Checking Health Before Scheduling

​Next Steps

List Integrations

Disconnect

Schedule Video

Dashboard

Authorizations

Path Parameters

Response

Overview

Endpoint

Path Parameters

Headers

Response

Request Example

Response Examples

Health Status Values

Checking Health Before Scheduling

Next Steps