# MagicPost

- [Introduction](https://magic-post.mintlify.app/getting-started/introduction.md): Create various text and media posts and distribute them to all channels at once using Magic Post
- [Requirements](https://magic-post.mintlify.app/getting-started/requirements.md): The PHP version, extensions, database, folder permissions and cron job your server needs before you install MagicPost.
- [Quickstart](https://magic-post.mintlify.app/getting-started/quickstart.md): Go from an empty server to your first published post, in the order an owner does it.
- [Web installer](https://magic-post.mintlify.app/installation/web-installer.md): Install MagicPost from your browser: what each step checks, what it writes, and how to sign in for the first time.
- [Manual and .env setup](https://magic-post.mintlify.app/installation/manual-setup.md): Prepare the server by hand before running the web installer: file upload, document root, database, the .env file and the installed marker.
- [Post-install checklist](https://magic-post.mintlify.app/installation/post-install-checklist.md): The tasks to finish on the first day, in the order that makes the rest easier.
- [Cron and queue](https://magic-post.mintlify.app/installation/cron-and-queue.md): The one cron job MagicPost needs, every task it runs, how posts are sent in cron or worker mode, and how to check that it is working.
- [Update instructions](https://magic-post.mintlify.app/updates/update-instructions.md): Follow update instructions as listed below for each version.
- [Changelog](https://magic-post.mintlify.app/updates/changelog.md): What each MagicPost release contains.
- [License activation](https://magic-post.mintlify.app/license/activation.md): Activate, check and deactivate your MagicPost license, and what to do when you move to a new server.
- [Extended license](https://magic-post.mintlify.app/license/extended-license.md): When an Envato Extended License applies to MagicPost, and how to switch an activated install to a different license.
- [Dashboard](https://magic-post.mintlify.app/user-guide/dashboard.md): Read the Home page: performance tiles, your channels, the next post going out, failed posts and plan usage.
- [Connect channels](https://magic-post.mintlify.app/user-guide/connect-channels.md): Link your social accounts, choose which ones to publish to, check their health, reconnect expired ones and stay within your plan limit.
- [Composer](https://magic-post.mintlify.app/user-guide/composer.md): Write one post, adapt it for each channel, attach media, check it against every network rule and then save, schedule or publish it.
- [AI writing and media](https://magic-post.mintlify.app/user-guide/ai-tools.md): Write captions, adapt them for each network, suggest alt text, and create or edit pictures and clips with AI, with credit cost and plan rules.
- [Scheduling](https://magic-post.mintlify.app/user-guide/scheduling.md): Publish now, pick a date and time, use your posting queue, repeat a post on a schedule or recycle a successful post as evergreen.
- [Calendar](https://magic-post.mintlify.app/user-guide/calendar.md): See everything you have lined up by month, week, day or agenda, drag posts to new times, and drop drafts onto the schedule.
- [Posts and statuses](https://magic-post.mintlify.app/user-guide/posts-and-statuses.md): Find, filter and manage every post, understand each status, and handle retries, duplicates and CSV export.
- [Approval workflow](https://magic-post.mintlify.app/user-guide/approvals.md): Require sign-off on team posts: who submits, who reviews, how to approve, request changes or reject, and what the plan must include.
- [Media library](https://magic-post.mintlify.app/user-guide/media-library.md): Upload images and videos once and reuse them in any post: folders, alt text, size limits, storage quota, how files are adapted for each network, and the watermark.
- [Saved captions and brand voice](https://magic-post.mintlify.app/user-guide/captions-and-brand-voice.md): Keep reusable captions and hashtag groups, and describe your tone once so the AI writing assistant follows it.
- [RSS feeds and CSV import](https://magic-post.mintlify.app/user-guide/feeds-and-import.md): Turn new blog articles into posts automatically with RSS feeds, and bring in many posts at once from a CSV spreadsheet.
- [Analytics](https://magic-post.mintlify.app/user-guide/analytics.md): Measure how your published posts perform: engagements, impressions, followers, top posts, best posting times and what works, with how often figures sync.
- [Profile and security](https://magic-post.mintlify.app/account/profile-and-security.md): Update your profile and photo, change your password, turn on two-factor authentication, set your time zone and delete your account.
- [Notifications](https://magic-post.mintlify.app/account/notifications.md): Read your notification inbox and choose which publishing and review events reach you in the app and by email.
- [Teams](https://magic-post.mintlify.app/account/teams.md): Create a team, invite people, assign approvers, share credits and follow what your team does.
- [Support tickets](https://magic-post.mintlify.app/account/support.md): Open a support ticket, follow the conversation with the support team and reopen it when you need more help.
- [Credits](https://magic-post.mintlify.app/account/credits.md): See your credit balance, what is on hold, where credits went and how AI writing and media runs use them.
- [Billing and subscription](https://magic-post.mintlify.app/account/billing.md): Choose a plan, pay at checkout, upload proof for bank transfers, download invoices and cancel your subscription.
- [Referrals](https://magic-post.mintlify.app/account/referrals.md): Share your referral link, track the people you refer, see your commission and request a payout.
- [API keys](https://magic-post.mintlify.app/account/api-keys.md): Create, use and revoke the keys that let your own scripts and tools read your posts and channels and line up new posts.
- [REST API](https://magic-post.mintlify.app/account/rest-api.md): Reference for the MagicPost REST API: authentication, rate limits, every endpoint, request fields, response shapes and errors.
- [Webhooks](https://magic-post.mintlify.app/account/webhooks.md): Send events to your own address the moment a post goes out, fails or needs attention, and verify each request with its signature.
- [Language and theme](https://magic-post.mintlify.app/account/language-and-theme.md): Switch the interface language and choose between the light, dark and system themes.
- [Publishing channels](https://magic-post.mintlify.app/channels/overview.md): How MagicPost connects to social networks: one app per network, connected accounts, channel states, and where publishing limits come from.
- [X (Twitter)](https://magic-post.mintlify.app/channels/x.md): Register an X developer app, store its keys in MagicPost, connect X accounts, and publish posts with images, video and a first comment.
- [LinkedIn](https://magic-post.mintlify.app/channels/linkedin.md): Choose between the profile-only and the profiles-and-Pages LinkedIn app, store its keys in MagicPost, and publish posts with images, video and link previews.
- [TikTok](https://magic-post.mintlify.app/channels/tiktok.md): Register a TikTok app with Login Kit and Direct Post, connect creators, and publish videos and photo posts with privacy, disclosure and cover options.
- [YouTube](https://magic-post.mintlify.app/channels/youtube.md): Set up a Google Cloud project for the YouTube Data API, connect channels, and publish videos and Shorts with title, visibility and first comments.
- [Pinterest](https://magic-post.mintlify.app/channels/pinterest.md): Register a Pinterest app, connect accounts, test in the Pinterest sandbox, and publish image, carousel and video pins to a board.
- [Facebook Pages](https://magic-post.mintlify.app/channels/meta/facebook.md): Register a Meta app, connect Facebook Pages and publish feed posts, Reels and Stories with first comments.
- [Instagram](https://magic-post.mintlify.app/channels/meta/instagram.md): Connect Instagram professional accounts through Facebook Login and publish feed posts, Reels and Stories.
- [Threads](https://magic-post.mintlify.app/channels/meta/threads.md): Register a Threads app, connect Threads profiles and publish text, image, carousel and video posts with reply control and topics.
- [WhatsApp channels](https://magic-post.mintlify.app/channels/whatsapp/overview.md): Choose a WhatsApp provider for your site, turn WhatsApp on, and see what a WhatsApp post can contain.
- [WAHA (self-hosted)](https://magic-post.mintlify.app/channels/whatsapp/waha.md): Run a WAHA server, connect it to MagicPost, and link a WhatsApp number by scanning a QR code.
- [Whapi.Cloud (hosted)](https://magic-post.mintlify.app/channels/whatsapp/whapi.md): Connect MagicPost to Whapi.Cloud and link a WhatsApp number through a Whapi.Cloud channel.
- [Official WhatsApp Cloud API](https://magic-post.mintlify.app/channels/whatsapp/official-cloud-api.md): Set up a Meta app for the WhatsApp Cloud API, connect a WhatsApp Business number, create groups and choose fallback templates.
- [Telegram channels](https://magic-post.mintlify.app/channels/telegram/overview.md): How MagicPost posts to Telegram channels and groups through a bot, with post limits, first comments and analytics.
- [Set up Telegram](https://magic-post.mintlify.app/channels/telegram/setup.md): Create a Telegram bot with @BotFather, save its token in MagicPost, and connect a channel or group.
- [Admin panel overview](https://magic-post.mintlify.app/admin/overview.md): A map of the MagicPost admin sidebar: what each section controls and which page of this documentation explains it.
- [Admin dashboard](https://magic-post.mintlify.app/admin/dashboard.md): What the admin dashboard shows: the Needs attention list, the key tiles, publishing activity, AI usage, support queue and website traffic.
- [Users](https://magic-post.mintlify.app/admin/users.md): Create, view, edit and delete customer accounts, adjust credits, and watch sign-ups and live activity from the Accounts section.
- [Channel credentials](https://magic-post.mintlify.app/admin/publishing-platforms.md): Register each social network's developer app in MagicPost, paste its keys, copy the exact callback URL, run the configuration checks and switch the network on for your users.
- [Publishing settings](https://magic-post.mintlify.app/admin/publishing-settings.md): Check that your server is ready to publish, choose how posts are sent, set retry and upload limits, add a watermark and control analytics collection.
- [AI models](https://magic-post.mintlify.app/admin/ai-models.md): Store provider API keys, switch writing and media models on or off, test them, set credit prices and add fal.ai endpoints.
- [General settings](https://magic-post.mintlify.app/admin/general-settings.md): Set the credits new accounts start with, choose where Image and Video Studio results are stored, and reach the settings of installed plugins.
- [Global settings](https://magic-post.mintlify.app/admin/global-settings.md): Change the site name, URL and time zone, and switch on Google Analytics, Google Maps and the reCAPTCHA fields from one admin page.
- [Registration and login](https://magic-post.mintlify.app/admin/registration-and-login.md): Open or close public sign-up, require email verification, and let people sign in with Google, Facebook, X or LinkedIn.
- [Email and SMTP](https://magic-post.mintlify.app/admin/smtp.md): Connect MagicPost to your mail server so verification links, support replies, failed-post alerts and other emails are actually delivered.
- [Privacy and cookies](https://magic-post.mintlify.app/admin/privacy-gdpr.md): Turn on the cookie consent banner for your public site and choose its layout, position, lifetime and dark mode.
- [Website content](https://magic-post.mintlify.app/admin/website-content.md): Manage the public landing site: page toggles and social links, SEO tags, logos, legal pages, FAQs, testimonials and Google AdSense.
- [Blog](https://magic-post.mintlify.app/admin/blog.md): Write and publish blog posts, feature them, set their SEO fields, and moderate reader comments from the Blogs Manager.
- [Support tickets](https://magic-post.mintlify.app/admin/support-tickets.md): Work through customer tickets in the admin queue: filter, read the conversation, reply with a screenshot, change the status and delete tickets.
- [System notifications](https://magic-post.mintlify.app/admin/system-notifications.md): Read, clear and act on the in-app notifications your admin account receives, such as new sign-ups and completed payments.
- [System status](https://magic-post.mintlify.app/admin/system-status.md): Where to see whether your MagicPost server is healthy, what each System health check means and how to fix a failing one.
- [Languages and translations](https://magic-post.mintlify.app/admin/languages.md): Add a language, translate the interface, switch languages on for your users, set the default and rebuild the language files with the Language Manager.
- [Plugins and themes](https://magic-post.mintlify.app/admin/plugins-and-themes.md): Browse the marketplace, buy or unlock plugins with a license key, install, update and uninstall them, and activate frontend or dashboard themes.
- [SaaS overview](https://magic-post.mintlify.app/saas/overview.md): Turn on billing in MagicPost, see what it switches on for admins and users, and set up the free tier, plans and payments in the right order.
- [Subscription plans](https://magic-post.mintlify.app/saas/plans.md): Create and edit plans under Finance, Pricing Plans: plan types, pricing, AI credits, limits, features, networks and how plans sync with payment gateways.
- [Free tier](https://magic-post.mintlify.app/saas/free-tier.md): Set the limits, features and networks that apply to users without a plan while SaaS Business is on, under Finance, Free tier.
- [Prepaid plans](https://magic-post.mintlify.app/saas/prepaid-plans.md): Sell one-time AI credit packs with prepaid plans: how to create them, how the credits are stored and spent, and how they differ from subscriptions.
- [Credits and allowances](https://magic-post.mintlify.app/saas/credits.md): How MagicPost grants, holds and spends AI credits: plan allowances, credit packs, registration credits, team sharing, per-run costs and admin adjustments.
- [Subscriptions](https://magic-post.mintlify.app/saas/subscriptions.md): Review every subscription under Finance, Subscriptions, assign a plan to a user by hand, read subscription details and understand cancellation.
- [Orders and transactions](https://magic-post.mintlify.app/saas/orders.md): Find every payment under Finance, Orders, read order details, approve or decline bank transfers by checking the proof of payment, and download invoices.
- [Finance settings](https://magic-post.mintlify.app/saas/finance-settings.md): Set the default currency, the invoice tax rate, whether checkout collects billing details, and the decimal points switch under Finance, Finance Settings.
- [Invoices](https://magic-post.mintlify.app/saas/invoices.md): Enter your company details under Finance, Invoice Settings, and learn how MagicPost numbers, builds and delivers PDF invoices for completed orders.
- [Referral program admin](https://magic-post.mintlify.app/saas/affiliates.md): Configure the referral program under Affiliates, track referrers and earnings, and process payout requests from your users.
- [Finance dashboard](https://magic-post.mintlify.app/saas/finance-dashboard.md): Read the revenue, subscription, order and gateway figures on Finance, Finance Dashboard, and learn exactly what each tile and chart counts.
- [Payment gateways](https://magic-post.mintlify.app/gateways/overview.md): Enable the payment methods your customers use to buy MagicPost plans, and learn how webhooks, return URLs, plan sync and renewals work.
- [Stripe](https://magic-post.mintlify.app/gateways/stripe.md): Connect Stripe to MagicPost to take card payments for one-time and recurring plans through Stripe Checkout.
- [PayPal](https://magic-post.mintlify.app/gateways/paypal.md): Connect PayPal to MagicPost to take one-time payments and recurring subscriptions with the PayPal REST API.
- [Paystack](https://magic-post.mintlify.app/gateways/paystack.md): Connect Paystack to MagicPost to take payments for one-time and recurring plans through the hosted Paystack checkout.
- [Razorpay](https://magic-post.mintlify.app/gateways/razorpay.md): Connect Razorpay to MagicPost to take payments for one-time and recurring plans in the Razorpay checkout window.
- [Mollie](https://magic-post.mintlify.app/gateways/mollie.md): Connect Mollie to MagicPost to take one-time payments and recurring subscriptions through the hosted Mollie checkout.
- [Flutterwave](https://magic-post.mintlify.app/gateways/flutterwave.md): Connect Flutterwave to MagicPost to take payments for one-time and recurring plans through the hosted Flutterwave checkout.
- [Paddle](https://magic-post.mintlify.app/gateways/paddle.md): Connect Paddle Billing to MagicPost to take one-time and recurring payments through the Paddle checkout overlay.
- [YooKassa](https://magic-post.mintlify.app/gateways/yookassa.md): Connect YooKassa to MagicPost to take payments in the hosted YooKassa checkout, and learn how recurring plans behave.
- [Braintree](https://magic-post.mintlify.app/gateways/braintree.md): Connect Braintree to MagicPost to take card and wallet payments for one-time and recurring plans through the Braintree Drop-in.
- [Iyzico](https://magic-post.mintlify.app/gateways/iyzico.md): Connect iyzico to MagicPost to take payments for one-time and recurring plans through the hosted iyzico checkout form.
- [Midtrans](https://magic-post.mintlify.app/gateways/midtrans.md): Connect Midtrans to MagicPost to take payments for one-time and recurring plans through the Midtrans Snap payment window.
- [Coinbase Commerce](https://magic-post.mintlify.app/gateways/coinbase.md): Accept crypto payments for one-time MagicPost plans through Coinbase Commerce, and check whether your account can still create charges.
- [Bank transfer](https://magic-post.mintlify.app/gateways/bank-transfer.md): Let customers pay for a plan by bank transfer, collect proof of payment, and approve the order to release the plan.
- [Wallet](https://magic-post.mintlify.app/gateways/wallet.md): Let customers pay for a plan from the balance stored on their MagicPost account, and understand what this version does and does not provide.
- [Plugins overview](https://magic-post.mintlify.app/plugins/overview.md): How MagicPost plugins work: what you need before installing one, how to install, update and uninstall it, and where each plugin's instructions are kept.
- [Integrations overview](https://magic-post.mintlify.app/integrations/overview.md): The AI providers behind MagicPost writing and media tools, and the social accounts people can use to sign in. Where each key goes and what it unlocks.
- [OpenAI](https://magic-post.mintlify.app/integrations/ai/openai.md): Add an OpenAI API key so MagicPost can write captions with GPT models and create or edit pictures.
- [Anthropic](https://magic-post.mintlify.app/integrations/ai/anthropic.md): Add an Anthropic API key so MagicPost can write captions, post versions and alt text with Claude models.
- [Google Gemini](https://magic-post.mintlify.app/integrations/ai/gemini.md): Add a Gemini API key so MagicPost can write captions, create and edit pictures, and make video clips with Google models.
- [xAI Grok](https://magic-post.mintlify.app/integrations/ai/xai.md): Add an xAI API key so MagicPost can write captions with Grok, create and edit pictures, and make video clips.
- [fal.ai](https://magic-post.mintlify.app/integrations/ai/fal.md): Add a fal.ai key to offer hosted picture and video models, and add any fal.ai endpoint by its id.
- [Google login](https://magic-post.mintlify.app/integrations/login/google.md): Let people sign in and register with their Google account. Create an OAuth client in Google Cloud and paste its credentials into Auth Settings.
- [Facebook login](https://magic-post.mintlify.app/integrations/login/facebook.md): Let people sign in and register with their Facebook account. Create an app in Meta for Developers and paste its App ID and App secret into Auth Settings.
- [X login](https://magic-post.mintlify.app/integrations/login/x.md): Let people sign in and register with their X account. Create an OAuth 2.0 app in the X Developer Console and paste its Client ID and Client Secret into Auth Settings.
- [LinkedIn login](https://magic-post.mintlify.app/integrations/login/linkedin.md): Let people sign in and register with their LinkedIn account. Create a LinkedIn app with the OpenID Connect product and paste its Client ID and Client Secret into Auth Settings.
- [Environment variables](https://magic-post.mintlify.app/advanced/environment-variables.md): Every .env key MagicPost reads, grouped by purpose, with defaults and the admin screens that write to the file.
- [File storage](https://magic-post.mintlify.app/advanced/storage.md): Where MagicPost keeps uploaded media and other files, which disks exist, how upload limits are decided and what to back up.
- [Video processing](https://magic-post.mintlify.app/advanced/video-processing.md): How MagicPost finds ffmpeg, what it uses it for, what stops working without it and how to fix the common causes.
- [Cache and optimisation](https://magic-post.mintlify.app/advanced/cache.md): Choose a cache store, learn what MagicPost keeps in it, which optimisation commands to avoid, and how to clear caches after a change.
- [Google Analytics](https://magic-post.mintlify.app/advanced/google-analytics.md): Track visitors on your public website and show Google Analytics figures on the MagicPost admin dashboard.
- [Google reCAPTCHA](https://magic-post.mintlify.app/advanced/google-recaptcha.md): What the Google reCAPTCHA v3 settings in Global Settings store, what they do not do yet, and the protections that do run on your forms.
- [Google Maps](https://magic-post.mintlify.app/advanced/google-maps.md): Add a Google Maps API key so the Accounts Dashboard can draw a map of where your registered users come from.
- [Installation problems](https://magic-post.mintlify.app/troubleshooting/installation.md): Fix failed requirement and permission checks, database errors, activation errors and blank pages while installing MagicPost.
- [Scheduler and queue problems](https://magic-post.mintlify.app/troubleshooting/scheduler-and-queue.md): Find out why posts stay scheduled or publishing, read the System health checks, and recover from a stopped cron job or queue.
- [Failed posts](https://magic-post.mintlify.app/troubleshooting/publishing-errors.md): Read why a post failed or is only partly published, how retries and waiting work, and what to do about each error code.
- [Channel connection problems](https://magic-post.mintlify.app/troubleshooting/channel-connections.md): Fix redirect URI mismatches, failed connections, apps still in review, expired authorisations and missing permissions on connected channels.
- [Billing problems](https://magic-post.mintlify.app/troubleshooting/billing-and-payments.md): Fix checkouts that will not start, payments that arrive but do not activate a plan, missing webhooks and bank transfer orders stuck as pending.
- [FAQ](https://magic-post.mintlify.app/troubleshooting/faq.md): Short answers to common questions about hosting, publishing, channels, files, email and billing in MagicPost.

## Optional

- [Buy MagicPost](https://berkine.dev/scripts/magicpost)
- [Support Tickets](https://support.berkine.dev/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.