Help and onboarding

Vistrify documentation

A single guide for new users: from account setup to fully automated publishing.

1. Quick start (10 minutes)

  1. Create your account and verify your email address.
  2. Add your site in Sites and set your target market (country + language).
  3. Generate keywords, create drafts, and review the content.
  4. Connect publishing (WordPress or API), then schedule dates in Calendar.

2. WordPress integration (easiest)

Use this option if your blog is running on WordPress.

  1. In WordPress go to Users -> Profile -> Application Passwords and create a new app password.
  2. In Vistrify: Integrations -> WordPress.
  3. Fill fields: wp_url (site URL), wp_username (WP user), wp_app_password (application password).
  4. Click Save WordPress, then publish one test draft from Drafts -> Publish to WordPress.

If successful, the article will appear immediately as a WordPress post.

3. Custom API / Webhook integration

Use this when you are not on WordPress or you publish to a custom CMS.

  1. Create an API endpoint that accepts POST requests.
  2. In Vistrify set webhook_url (full endpoint URL) and optionally api_key.
  3. Save the connection and test publishing on one draft.

Request format sent by Vistrify

POST /your-endpoint
Content-Type: application/json
Authorization: Bearer <api_key>   // only if api_key is set

{
  "title": "Article title",
  "body": "# Markdown content",
  "format": "markdown"
}

Minimum endpoint response

HTTP/1.1 200 OK
{ "ok": true }

4. How auto-publishing works

  1. In Calendar, drag keywords to dates or use Auto-schedule.
  2. A daily cron job generates and publishes scheduled posts.
  3. If publishing fails, the draft is still generated and waits for manual Publish.

5. Common errors and quick fixes

  • 401 / 403: invalid credentials (WP app password or API token).
  • 404: wrong webhook URL or missing endpoint.
  • 502: Vistrify cannot reach your endpoint or your endpoint returned an error.
  • "No connection configured": no publish connection saved for the active site.
  • Post not visible: your endpoint accepts data but does not store/publish it in your CMS.

6. Support

If you want us to verify your setup step-by-step, email info@vistrify.com with your domain and integration type (WordPress or API).