Connect social media to Fondoo

What Fondoo can do with it

• Link accounts with connect_social, then load them with refresh_social_accounts and list_social_accounts.
• Draft posts. draft_social_posts writes AI captions, one per account. save_social_draft saves your own text without AI.
• Schedule and approve. schedule_social_posts picks slots inside your posting windows. approve_social_posts confirms exact posts. Fondoo's internal publisher then sends them when due.
• Media, calendar, stats and cancelling. Use register_social_media for real media, get_social_calendar for the calendar and get_social_stats for results. cancel_post cancels a post.

Links in posts are turned into tracked links, so visits can be tied back to each post.

What needs your approval: choosing a provider (set_provider), saving provider credentials and changing posting rules are owner-only. Posts wait for approval unless you, signed in as the owner, set a network to auto. Reddit and Lemmy posts always need approval.

Before you start: choose a provider

Fondoo can post through two services. Each site uses one, and Upload-Post is the default.

To see the current choice, run get_providers({siteId}). It returns the choices and the selected provider for each capability. To switch, the owner runs:

set_provider({ siteId, capability: "social", provider: "postiz" })   // or "upload_post"

Leave out siteId to set the workspace default. A site's own setting overrides the workspace default. Once a provider is chosen, accounts from the other provider are refused with "Account does not use the selected social provider".

Each social set counts against your plan's social-set allowance. Builder and Launch include 1, Growth 3 and Agency 10. This may differ for your account. A set holds one account per network.

Step by step: authorize your accounts

1. Pick your provider (above).
2. Upload-Post: your agent runs connect_social. You open the returned page and sign in to each network. See upload_post.md.
3. Postiz: connect channels in Postiz. Then the owner saves the Postiz key with configure_social_connection. See postiz.md.
4. Networks without a sign-in page (Discord, Telegram, Slack, Mastodon, Nostr, Lemmy, DEV, Hashnode, WordPress, Whop, listmonk): on Upload-Post, the owner runs configure_upload_post_platform. Each network's guide lists its fields.
5. Run refresh_social_accounts.
6. The owner turns on each network with update_distribution_rules. Networks stay off until listed. Defaults: 1 post a day, 09:00 to 17:00 UTC, review approval.

Network capabilities

These are Fondoo's built-in, conservative defaults. Your account or plan may allow less. Neither provider supports the thread format (multi-part posts), even where the network does. Required fields go in a post's details or in the account's settings (configure_social_account).

Notes:

• Character limits are checked after Fondoo adds tracked links.
• Titles must be at least 3 characters. canonicalUrl must be an HTTPS link to the original post.
• Fondoo doesn't collect stats for Discord, Telegram, Slack, Nostr, Lemmy, DEV, Hashnode, WordPress, Whop or listmonk. Through Upload-Post, it also doesn't collect them for Mastodon.
• For X links you can connect your own developer key (x_byo.md).

Connect it in Fondoo

(a) Dashboard. Open Connections. While a site has no social set, the Available card lists Social plus LinkedIn, Instagram, Facebook, X, TikTok, YouTube, Reddit, Bluesky, Pinterest and Threads. Connect followed by the network name shows Continue connecting and a Connect securely button with the setup steps. That button doesn't link the account itself, so use the agent route. Linked accounts appear in Connected with Reconnect. The other networks, Upload-Post and Postiz are not listed by name.

(b) Ask your agent. Example prompt:

"Show which social provider site YOUR-SITE-ID uses, then give me a link to connect Instagram and LinkedIn."

get_providers({ siteId })
connect_social({ siteId, provider: "upload_post", network: "instagram", set: 1, redirectUrl: "https://example.com/connected" })
refresh_social_accounts({ siteId, connectionId })

connect_service({provider:"social", siteId}) returns the same setup steps plus a signed link that expires after 15 minutes.

REST equivalent: POST https://api.getfondoo.com/v1/ops/<operation> with Authorization: Bearer <Fondoo API key> and the JSON body.

Test that it works

1. list_social_accounts({siteId}) lists accounts, connections and each provider's capabilities.
2. get_connection_health({siteId}) checks each social connection with its provider.
3. get_publishing_capacity({siteId}) shows today's remaining posts per account.
4. Try schedule_social_posts with "dryRun": true before your first real post.

Troubleshooting

• "Provider does not serve this capability". set_provider only accepts upload_post or postiz for social.
• "Enable NETWORK in distribution rules first". The owner needs to add the network with update_distribution_rules.
• "Format not supported by this adapter/network". Pick a format from the table. thread doesn't work through either provider.
• "NETWORK character limit (LIMIT) exceeded after link tracking". Shorten the text. Tracked links can be longer than the original links.
• "Social providers are not configured". Social posting isn't turned on for this Fondoo server. Contact Fondoo support.

Limits, data and security

• Fondoo's posting rules, your plan's set allowance and each provider's caps all apply. See upload_post.md and postiz.md for vendor limits.
• Fondoo stores account names and IDs, posts and metrics. Customer credentials, such as a Postiz key or an X key, are encrypted and never returned. Upload-Post holds the network tokens for accounts linked through it.
• To disconnect, unlink the account at the provider or revoke the app on the network. Then run refresh_social_accounts.

Official links

• Upload-Post documentation: https://docs.upload-post.com/
• Postiz documentation: https://docs.postiz.com/
• Per-network guides: see the table above