Skip to main content
GET

Overview

Returns one connected social account with a basic health check of its stored token. Use it before scheduling to make sure the connection still works.
If health.status is expired or error, reconnect the account in the Hooked dashboard (Studio → Channels). Reconnecting the same account updates this integration and keeps its id.
The health check only reads the stored token: expired when the token has an expiry date in the past, error when a TikTok connection has no access token, healthy otherwise. It does not call the platform, so healthy does not guarantee the platform will accept a post.

Errors

Next Steps

Schedule Post

Publish a video to this account

Disconnect Integration

Remove the connection

Authorizations

x-api-key
string
header
required

Path Parameters

integrationId
string
required

The integration id, from /v1/integration/list

Response

Integration

success
boolean
data
object