Social API

The Social API exposes the social accounts a user has connected to VDClip. It is read-only: list the connected accounts to discover which platforms are available before you publish or schedule a clip. Each entry gives the platform, the account handle, and its connection status. Use these identifiers as publishing targets when you call the publish endpoint on a clip. Connecting and disconnecting accounts happens in the VDClip dashboard, not through the API.

Conventions

Successful responses return the resource directly with no wrapping envelope. The list endpoint pages with a cursor query parameter (max 100) and returns { "items": [...], "next_cursor": "<opaque>" | null }. Errors return { "errors": [{ "code", "description", <location>? }] }; common codes here are invalid_api_key (401), missing_scope (403), and rate_limited (HTTP 429 with a Retry-After header).

Endpoints