Hanzo
OpenapiSocial

Reports each supported network's publish-readiness: whether this deployment…

Reports each supported network's publish-readiness: whether this deployment holds the OAuth application credentials for it and, when it does not, exactly…

GET /v1/social/providers

Addresshttps://api.hanzo.ai/v1/social/providers
MethodGET
Operationget_social_providers
AuthAuthorization: Bearer $HANZO_API_KEY

Reports each supported network's publish-readiness: whether this deployment holds the OAuth application credentials for it and, when it does not, exactly which environment variables are missing.

This is a live read of the deployment's own configuration, not a static list of networks — it answers "can I connect this today", which is what a connect affordance and a pre-cutover checklist both need. It says nothing about whether the caller has connected an account; that is the accounts listing.

Request

GET /v1/social/providers takes no parameters and no body — the credential is the whole request.

Response

StatusBodyMeaning
200socialProvidersok

200 body — 4 fields.

FieldInTypeAlwaysDescription
databodysocialProvider[]Data is one row per supported network, in the product's fixed order: x, facebook, instagram, linkedin, tiktok, youtube, threads.
data[].credentialsConfiguredbodybooleanCredentialsConfigured is whether this deployment holds every OAuth application credential the network needs.
data[].missingCredentialsbodystring[]MissingCredentials names the environment variables still unset for this network, so the answer is an installation instruction rather than a refusal.
data[].providerbodystringProvider is the network: x, facebook, instagram, linkedin, tiktok, youtube or threads.

Failure carries the platform error shape — see Errors.

Examples

hanzo social providers

Social API · All Hanzo APIs · Interactive reference

How is this guide?

On this page