Ghost — Connect it to MokonyxSocial

Details
Category: MokonyxSocial
  • Applicable Software: MokonyxSocial
  • Min Version Number: 01.03.00 and later
  • Max Version Number: Not Applicable

Connect your Ghost blog and MokonyxSocial can publish your content straight to it as a real blog post — title, body, and all — not just a link. This guide walks you through it in plain steps.

What you need

  • Your own Ghost blog — either Ghost(Pro) (an address like https://yoursite.ghost.io) or a self-hosted Ghost site on your own domain.
  • Admin (Owner or Administrator) sign-in to that Ghost site, so you're allowed to add an integration.
  • The blog available over the internet with https:// (MokonyxSocial talks to it directly).

Get your credentials

You'll grab two things from inside your Ghost blog's settings: a website address and an API key.

Your site address — admin_api_url (required)

This is simply your blog's web address — the same one you type to log in, minus the /ghost/ part at the end.

  1. Sign in to your Ghost blog. You'll be at something like https://yoursite.ghost.io/ghost/.
  2. Look at the address bar and copy just the beginning: https://yoursite.ghost.io (your own domain if self-hosted). Leave off the /ghost at the end — MokonyxSocial adds the rest for you.

Your API key — admin_api_token (required)

This is a special key that lets MokonyxSocial post for you. It looks like a long code with a colon in the middle (something:somethingelse).

  1. In your Ghost blog, click the Settings gear.
  2. Go to Advanced → Integrations.
  3. Click Add custom integration, name it something you'll recognize like "MokonyxSocial", and save.
  4. On the page that opens, find the Admin API Key and copy the whole thing (including the colon in the middle). That's your admin_api_token.
  5. Double-check: copy the Admin API Key, *not* the "Content API Key" — only the Admin key can create posts. Keep the whole id:secret value together.

Set it up in MokonyxSocial

  1. In Joomla admin, go to Components → MokonyxSocial → Services → New.
  2. Choose Ghost.
  3. Enter the credentials from the section above.
  4. Click Send Test to verify the connection, then Save & Close and ensure the service is Published.

Verify

  • After Send Test, you should see a success message.
  • Let MokonyxSocial send a post, then open Posts in your Ghost blog — your new post should be sitting there.

Troubleshooting

  • It says the login/token is invalid — copy the API key again, all of it including the colon, and make sure it's the Admin API Key, not the Content one.
  • It can't find your site — your site address is probably off. Use just https://yoursite.ghost.io with nothing after the domain, and check the blog opens in a browser.
  • A "token expired" message — this usually means your server's clock is wrong. Ask your host to make sure the server time is correct.
  • The post won't save — every post needs a title, and very fancy content can trip Ghost up. Try simpler content and send again.

Notes & limits

  • Ghost gets a full blog post from you — a headline and the article body.
  • The API key is like a master password for your blog; keep it private, and if it ever leaks, delete that integration in Ghost and make a new one.
  • Whether the post goes out as a draft or live depends on your MokonyxSocial settings.
Hits: 2