Skip to main content

Troubleshooting

Check the workspace, connection status, post result, and Billing before retrying a publishing or payment action. An uncertain result can mean the first action already succeeded.

My agent cannot see an account​

Confirm that the agent was authorized for the workspace holding that account. Switching workspaces in the dashboard does not change the agent's authorization.

Run list_accounts and use the IDs it returns. Personal Facebook authorizations are not publishing destinations; connect the Page you intend to publish to. Beta networks may be unavailable to your account until platform approval is complete.

Agent authorization fails​

Only workspace owners and admins can authorize agent connections. Check the selected workspace and your role, then reconnect using the exact server URL: https://mcp.unipost.ai/mcp.

If access expired, let the client refresh it or sign in again. If your client does not support OAuth, configure an API key as a bearer header. Never send your password or credential to support.

A post is still waiting for approval​

Agent-created posts start as pending_approval. Review and approve through the chat, the approval link, or Overview → Needs attention. A post's scheduled time passing does not authorize it to publish.

If another person's agent created it, use the UniPost approval screen. TikTok posts also require that screen for their privacy and interaction settings.

A scheduled post failed​

Read its error message in UniPost or through list_posts. Check whether the connection needs reconnecting, the plan covers the connected account count, and the media fits each destination's rules.

For X, call get_x_allowance to check credits and rolling posting limits. Fix the cause and confirm which destination posts already succeeded before scheduling a replacement.

A media URL is rejected​

Use a public HTTPS link that downloads the actual supported image or video, rather than a login page, share page, or HTML preview. Check the response's media type and file size. Private network URLs and downloads requiring cookies or authorization are unsuitable.

See media limits. For a post targeting several networks, satisfy every destination's rules.

Analytics show dashes or missing values​

New metrics may take a few hours to arrive. Not every platform provides every metric, and LinkedIn profiles and X do not currently report post analytics to UniPost. Missing data is not proof of zero engagement.

Checkout finished, but Billing has not updated​

Return to the owner's Billing page and check status, quantity, interval, and renewal details. Allow time for the payment result to synchronize. A success URL or toast alone is not proof of activation.

Reuse and investigate the existing purchase before starting another subscription. If it remains unconfirmed, contact support with the approximate time and the visible checkout or Billing result, without payment credentials.

My agent wallet cannot complete payment​

Use the agent checkout guide. UniPost uses the existing Stripe managed subscription checkout and does not expose an MPP endpoint. If the wallet cannot support the offered payment method or future renewals, hand that checkout to the buyer to finish.

Contact support​

Visit Support or email info@intuicodigital.com. Include the workspace, affected platform, visible error, approximate time, and post ID if relevant. Leave out passwords, API keys, OAuth tokens, card details, and wallet credentials.