Channel Connect
channel_connectStart or reconnect a social channel by generating a sign-in link; sign in to FirstReply and the platform to create or reauthorize the channel.
Instructions
Start connecting an account that is connected by signing in on the platform: MESSENGER, INSTAGRAM, LINKEDIN, WHATSAPP, THREADS, X, TIKTOK, YOUTUBE, GOOGLE_BUSINESS, MASTODON (MESSENGER is a Facebook Page). Returns a link (authUrl): the user opens it in a browser where they are signed in to FirstReply as the organization's owner, signs in on the platform, and FirstReply creates the channel; when the login can connect several accounts (Pages, locations, ...) FirstReply asks which one. The link is valid for 10 minutes. With channelId it reconnects that channel instead: after an expired or revoked login, or to grant more capabilities. Facebook Pages grant one capability per login, so ask for one at a time (first connect, then once more with channelId for PUBLISHING). Afterwards check channel_get: publishingAuthorized tells whether posts are allowed, channel_update turns publishingEnabled on.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"organizationId": "<organizationId>"
},
"name": "channel_connect"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name of the new channel as the team sees it. Required without channelId. | |
| server | No | MASTODON: the server the account is on, e.g. mastodon.social. | |
| platform | No | The platform of a new channel. Not needed with channelId. | |
| channelId | No | An existing channel to reconnect instead of creating one. | |
| capabilities | No | What the login asks for on Facebook, Instagram and TikTok (TikTok: COMMENTS on a reconnect adds the comments login). Default MESSAGING. Other platforms have one login for everything. | |
| organizationId | Yes | The organization id. Use organization_list to find it. |