Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trypost.it/llms.txt

Use this file to discover all available pages before exploring further.

What are social accounts?

Social accounts are the connections between TryPost and your social media profiles or pages. When you connect an account, TryPost gets permission to create and publish posts on your behalf.

Supported platforms

PlatformIdentifierAccount typesAuth method
LinkedInlinkedinPersonal profilesOAuth
LinkedIn Pagelinkedin-pageCompany pagesOAuth
X (Twitter)xPersonal accountsOAuth
FacebookfacebookPagesOAuth
Instagram (Standalone)instagramPersonal IG via Instagram’s own OAuthOAuth
Instagram (Facebook Business)instagram-facebookBusiness / creator accounts linked to a Facebook pageOAuth (via Facebook)
TikToktiktokPersonal and business accountsOAuth
YouTubeyoutubeChannelsOAuth (via Google)
ThreadsthreadsPersonal accountsOAuth
PinterestpinterestPersonal and business accountsOAuth
BlueskyblueskyPersonal accountsApp Password
MastodonmastodonAny instanceOAuth (per instance)

Connecting an account

Go to Accounts in the dashboard and click the platform you want to connect. For most platforms, you’ll be redirected to their authorization page. A few have extra steps:
  • LinkedIn Page — after authorizing, pick which company page to connect
  • Facebook — after authorizing, pick which page to manage
  • Instagram (Standalone) — uses Instagram’s own OAuth flow; suitable for personal IG accounts
  • Instagram (Facebook Business) — authorize through Facebook, then pick the Instagram account linked to a Facebook page (required for first-party publishing of feed/reels/stories/carousels)
  • YouTube — authorize with Google, then pick the channel
  • Bluesky — enter your handle and an App Password (not your main password)
  • Mastodon — enter your instance URL first, then authorize on that instance
You can connect multiple accounts per platform — for example, both your personal LinkedIn and three company pages.

Connection limits (Cloud only)

On TryPost Cloud, each plan caps the total number of connected accounts per workspace:
PlanConnected accounts
Starter5
Plus10
Pro30
Max100
Self-hosted instances have no cap. When you exceed the limit on Cloud, connecting a new account returns 402 Payment Required and the dashboard prompts you to upgrade.

Active vs. inactive

Each social account can be toggled between active and inactive:
  • Active — The account is included when creating new posts. New posts will have a platform entry for this account.
  • Inactive — The account is excluded from new posts. Existing scheduled posts are not affected.
Toggle an account’s active state from the Accounts page or via the API.
Use inactive mode when you want to temporarily pause posting to a specific account (e.g., during a holiday) without disconnecting it.

Connection status

StatusDescriptionAction needed
ConnectedWorking correctly, TryPost can publish postsNone
DisconnectedAuthorization was revoked or token expiredReconnect the account
Token expiredAccess token expired and couldn’t be refreshedReconnect the account
TryPost runs a daily check on all connected accounts to verify their tokens are still valid. If an account is found disconnected, the workspace owner receives a notification (in-app and email).

Why accounts get disconnected

  • Token expiration — Some platforms issue short-lived tokens. TryPost automatically refreshes them, but if the refresh fails (e.g., the refresh token also expired), the account disconnects.
  • Password change — Changing your password on the platform may revoke all OAuth tokens.
  • Permission revoked — You manually revoked TryPost’s access in the platform’s settings.
  • Platform policy — The platform may revoke tokens for inactivity or policy changes.

Token security

  • Access tokens and refresh tokens are encrypted at rest using Laravel’s encryption
  • Tokens are never exposed in API responses — the access_token and refresh_token fields are hidden
  • Each account stores its token expiry date and TryPost proactively refreshes tokens before they expire

Disconnecting an account

Go to Accounts, find the account, and click Disconnect. This:
  • Removes the connection from TryPost
  • Does not affect existing published posts
  • Does not revoke TryPost’s access on the platform (you can do that in the platform’s settings)

FAQ

No. Each social media account can only be connected once per workspace. If you try to connect an account that’s already connected, TryPost will update the existing connection.
Posts scheduled for a disconnected account will fail for that platform when the scheduled time arrives. Other platforms in the same post are not affected. You’ll receive a notification about the failure.
Usually no. TryPost automatically refreshes tokens. However, some platforms (like TikTok) have shorter token lifetimes and may occasionally require reconnection.
Yes. Each workspace manages its own connections independently. The same LinkedIn profile can be connected in multiple workspaces.