Connections API

Manage platform connections and view OAuth credentials status.

List Connections

Retrieve all platform connections in a workspace.

GET /rest/v1/connections?workspace_id=eq.<workspace-id>&select=*

Response

[
  {
    "id": 1,
    "workspace_id": "uuid",
    "platform": "instagram",
    "status": "active",
    "created_at": "2025-01-01T00:00:00Z",
    "updated_at": "2025-01-01T00:00:00Z"
  }
]

Get Connection

Retrieve a single connection with its channels.

GET /rest/v1/connections?id=eq.<id>&select=*,channels(*)

Connection Status

Sync Connection

Refresh OAuth tokens and sync channel data using the Edge Function:

POST /functions/v1/sync
Content-Type: application/json
 
{
  "connection_id": 1
}

Import Channels

Import or refresh channels from a connected platform:

POST /functions/v1/import-channels
Content-Type: application/json
 
{
  "connection_id": 1
}

This fetches the latest channels (pages, groups, profiles, etc.) from the platform and creates or updates them in QiQ Social.

Delete Connection

DELETE /rest/v1/connections?id=eq.<id>

Deleting a connection also removes all associated channels and their output assignments from automations.

Supported Platforms