Integrations

Integrations are how Mediastilo publishes your finished drafts to the places your audience actually reads. You connect a destination once per brand, and from then on you can push any ready draft straight to it. Connections are managed from the Integrations section of your dashboard.

Supported destinations

Mediastilo ships with three publishing destinations today:

Destination	What you connect	What you'll need
WordPress	A self-hosted or WordPress.com site via the REST API	Site URL, username, and an Application Password
Ghost	A Ghost site via the Admin API	Admin API URL and an Admin API Key (`id:secret`)
Webhook / Custom REST	Any HTTP endpoint you control	Endpoint URL and a signing secret

Each destination is a per-brand connection, connecting WordPress for one brand doesn't connect it for the others. See Workspaces & Brands.

Publishing is a plan-gated feature. If you don't see Integrations or the Push action, check your plan in Credits & Billing.

Connecting a destination

Go to Integrations and choose a destination type.
Fill in its fields (see below). Secret fields, passwords, API keys, signing secrets, are encrypted at rest and masked whenever you view the connection again.
Mediastilo runs a test connection to confirm the credentials work before saving.
The connection shows as Active when it's good, or Error if a later check fails (for example, if you rotate a key on the destination).

You can re-run the test at any time, reconnect with new credentials, or disconnect a destination entirely.

WordPress

WordPress has a guided setup. Click Set up with guide, enter your site address, and Mediastilo checks the site and offers the smoothest path:

One-click authorization (recommended). If your site supports it, Mediastilo sends you to your own WordPress to approve access, with no passwords to copy. WordPress generates an Application Password and hands it back automatically.
Manual entry (fallback). If one-click isn't available, create an Application Password in WordPress (Users → Profile → Application Passwords) and paste it with your site URL and username.

After connecting, the wizard lets you choose publishing defaults (the post type, default categories, and whether posts go out published or as a draft) and optionally refresh your Brand voice by re-analyzing the site (this uses one analysis credit). You can change these later from the WordPress connection (Edit publishing defaults).

Ghost

Mediastilo uses the Ghost Admin API. In Ghost, create a Custom Integration (Settings → Integrations → Add custom integration) to get an Admin API key in the form id:secret, plus the Admin API URL. Paste both here.

Webhook / Custom REST

For anything else, point Mediastilo at an endpoint URL you control. On publish, Mediastilo sends a JSON POST describing the content, signed with an X-Mediastilo-Signature: sha256=… header derived from your signing secret so your receiver can verify the request is genuine. A ping event is sent when you test the connection.

Publishing a draft

Once a destination is connected and a draft is Ready, use Push in the editor or draft view to send it. You can publish to several destinations at once by selecting them. For a selected WordPress destination, you can fine-tune the post type, categories, tags, and status right there, pre-filled from your saved defaults and overridable per publish. Mediastilo:

Sends the title and body, as a published post (or a scheduled one, if you set a publish time), with your chosen post type, categories, and tags.
Records the result, the destination's post ID and a link to view it.
Marks the publication published or failed, with the error if something went wrong, so you can fix the connection and try again.

See Drafts & Publishing for the full draft lifecycle.

Troubleshooting

Connection shows Error: re-run the test. The most common causes are a rotated API key, an expired Application Password, or a changed site URL. Reconnect with fresh credentials.
WordPress fails: confirm the Application Password (not the login password) and that the REST API is reachable at …/wp-json/.
Ghost fails: confirm the key is the full id:secret Admin API key and the URL points at your Ghost admin domain.
Webhook fails: confirm your endpoint returns a 2xx status for the ping event and verifies the X-Mediastilo-Signature header.

What's next for integrations

The connection model is built to grow, destinations are pluggable, and one-click authorization is already live for WordPress. Bringing the same paste-free sign-in to more platforms is on the roadmap. New destinations appear in the Integrations list automatically as they ship.