# social-channels

> Instagram, Facebook Page and Threads channels.

Instagram, Facebook Page and Threads channels.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| DELETE | `/v1/channels/{channel_id}/social` | `social_channels_disconnect`: Disconnect a social channel (history is kept) | `channels:write` | - |
| GET | `/v1/channels/{channel_id}/social/capabilities` | `social_channels_capabilities`: What this social channel can do (Threads = no DMs) | `channels:read` | - |
| GET | `/v1/channels/{channel_id}/social/health` | `social_channels_health`: Live health of a social channel | `channels:read` | - |
| POST | `/v1/channels/{channel_id}/social/health/refresh` | `social_channels_health_refresh`: Force a health re-check against Meta | `channels:write` | - |
| GET | `/v1/channels/{channel_id}/social/ice-breakers` | `social_channels_get_ice_breakers`: Ice breakers (Instagram / Messenger) | `channels:read` | - |
| PUT | `/v1/channels/{channel_id}/social/ice-breakers` | `social_channels_set_ice_breakers`: Replace ice breakers (Instagram max 4 per locale) | `channels:write` | - |
| POST | `/v1/channels/{channel_id}/social/reconnect` | `social_channels_reconnect`: Re-authorise an expired or revoked social channel | `channels:write` | - |
| POST | `/v1/channels/{channel_id}/social/refresh-token` | `social_channels_refresh_token`: Refresh the long-lived token now | `channels:write` | - |
| POST | `/v1/channels/social/connect-sessions` | `social_channels_create_connect_session`: Start connecting Instagram, a Facebook Page or Threads | `channels:write` | - |
| GET | `/v1/channels/social/connect-sessions/{session_id}` | `social_channels_get_connect_session`: Poll connect progress | `channels:write` | - |
| POST | `/v1/channels/social/connect-sessions/{session_id}/callback` | `social_channels_connect_callback`: Finish the Meta login: exchange the code, check permissions, list accounts | `channels:write` | - |
| POST | `/v1/channels/social/connect-sessions/{session_id}/select-asset` | `social_channels_select_asset`: Choose the Page / Instagram account / Threads profile to connect | `channels:write` | - |
| POST | `/v1/meta/deauthorize` | `meta_deauthorize_callback`: Meta deauthorize callback (Facebook / Instagram access removed) | public | - |

Request and response schemas: the interactive reference at `https://api.wapitick.com/docs`, or `docs/api/openapi.json`.
