Integrations Documentation

Getting started

Create a project from the Onboarding flow (or via Settings).
Connect an integration (WordPress recommended).
Configure publishing settings and schedule content.

WordPress plugin (recommended)

Download the plugin: Distribb Plugin (.zip)
In WP Admin → Plugins → Add New → Upload Plugin → select the .zip → Install → Activate.
Open WP Admin → Distribb, copy your Integration Key.
In Distribb → Integrations → WordPress → enter Site URL and Integration Key, then Connect.

Notes:

Draft vs Publish behavior is controlled from the WP plugin settings.
The plugin exposes secure endpoints under /wp-json/distribb/v1/.

Optional: style callouts to match your theme

Distribb articles include semantic classes for visual callouts so your WordPress theme controls the look. If your theme doesn’t style them, paste the snippet below into WP Admin → Appearance → Customize → Additional CSS to match the on-platform preview. Tweak colors to match your brand.

blockquote {
  border-left: 4px solid #3b82f6;
  margin: 1.5em 0;
  padding: 1em 1.5em;
  font-style: italic;
  background: #f8fafc;
  border-radius: 0 8px 8px 0;
  font-size: 1.1em;
  color: #1e293b;
}
.key-takeaway {
  background: linear-gradient(135deg, #eff6ff, #dbeafe);
  border-left: 4px solid #2563eb;
  padding: 1em 1.5em;
  margin: 1.5em 0;
  border-radius: 0 8px 8px 0;
}
.key-takeaway strong { color: #1e40af; }
.stat-highlight {
  text-align: center;
  padding: 1.5em;
  margin: 1.5em 0;
  background: #f0fdf4;
  border-radius: 12px;
  border: 1px solid #bbf7d0;
}
.stat-highlight .stat-number {
  display: block;
  font-size: 2.5em;
  font-weight: 800;
  color: #16a34a;
  line-height: 1.2;
}
.stat-highlight .stat-label {
  display: block;
  font-size: .95em;
  color: #374151;
  margin-top: .3em;
}
.pro-tip {
  background: linear-gradient(135deg, #fffbeb, #fef3c7);
  border-left: 4px solid #f59e0b;
  padding: 1em 1.5em;
  margin: 1.5em 0;
  border-radius: 0 8px 8px 0;
}
.pro-tip strong { color: #92400e; }

WordPress (App Password fallback)

We now default to the plugin. If you still need App Password:

Create an Application Password for your WP user (Users → Profile).
In Distribb → Integrations → WordPress → enter Site URL, Username, and App Password.

This path remains supported for backward compatibility.

API Webhook

Use a custom webhook to receive article payloads directly from Distribb. This lets you connect any custom CMS, internal tool, or third-party platform that accepts HTTP POST requests.

Setup

Go to Integrations → API Webhook.
Enter your Webhook Endpoint — a publicly reachable HTTPS URL that accepts POST requests.
Enter your Access Token — any secret string your server uses to authenticate incoming requests.
Click Test Your Webhook to verify your endpoint returns a 2xx response before saving.

How it works

When Distribb publishes an article, it sends a single POST request to your endpoint with the full article payload as JSON. Distribb retries up to 3 times (with exponential backoff) on 5xx errors or timeouts.

Request headers

POST {your-endpoint}
Content-Type: application/json
Authorization: Bearer {your-access-token}
User-Agent: Distribb-Publisher/1.0

Request body

{
  "data": {
    "articles": [
      {
        "title": "10 Tips for Better SEO in 2025",
        "slug": "10-tips-for-better-seo-2025",
        "content_html": "<h2>Introduction</h2><p>HTML content...</p>",
        "content_markdown": "## Introduction

Markdown content...",
        "meta_description": "Improve your rankings with these 10 proven SEO tips.",
        "image_url": "https://example.com/images/featured.jpg",
        "alt_text": "A laptop with SEO charts on screen",
        "tags": ["SEO", "Content Marketing", "Digital Marketing"],
        "author": "Jane Smith",
        "status": "Published"
      }
    ]
  }
}

Field reference

Field	Type	Description
`title`	string	The article title.
`slug`	string	URL-safe slug (e.g. `my-article-title`).
`content_html`	string	Full article body as HTML. Use this if your platform renders HTML.
`content_markdown`	string	Full article body as Markdown. Use this if your platform accepts Markdown.
`meta_description`	string	SEO meta description for the article.
`image_url`	string \| null	Featured image URL. `null` if no image is set.
`alt_text`	string \| null	Alt text for the featured image. `null` if none.
`tags`	array of strings	List of keywords / tags for the article.
`author`	string	Display name of the article author.
`status`	string	`"Published"` or `"Draft"` — driven by your project publishing preference.

Expected response

Return any HTTP 2xx status code to confirm receipt. The response body is not validated — return whatever you like.

HTTP/1.1 200 OK
Content-Type: application/json

{ "success": true }

Non-2xx responses mark the article as failed. 5xx responses trigger automatic retries (up to 3 attempts).

Authentication

Your Access Token is sent as a Bearer token in every request:

Authorization: Bearer your-secret-token-here

Verify this header on your server and reject unrecognized tokens with 401 Unauthorized.

Example — Node.js / Express

const express = require('express');
const app = express();
app.use(express.json());

app.post('/my-webhook', (req, res) => {
  const token = (req.headers['authorization'] || '').replace('Bearer ', '');
  if (token !== process.env.MY_SECRET_TOKEN) {
    return res.status(401).json({ error: 'Unauthorized' });
  }

  const articles = req.body?.data?.articles || [];
  for (const article of articles) {
    console.log('Received:', article.title, '| Status:', article.status);
    // Save to your CMS or database here
  }

  res.status(200).json({ success: true });
});

app.listen(3000);

Example — Python / Flask

from flask import Flask, request, jsonify
import os

app = Flask(__name__)

@app.route('/my-webhook', methods=['POST'])
def receive_article():
    auth = request.headers.get('Authorization', '')
    if auth != f"Bearer {os.environ['MY_SECRET_TOKEN']}":
        return jsonify({'error': 'Unauthorized'}), 401

    articles = request.json.get('data', {}).get('articles', [])
    for article in articles:
        print(f"Received: {article['title']} ({article['status']})")
        # Save to your DB or CMS here

    return jsonify({'success': True}), 200

Testing

Use the Test Your Webhook button in the integration modal to send a sample payload to your endpoint before going live. This confirms your URL is reachable, your token is accepted, and your handler responds with a 2xx.

Troubleshooting

WordPress 403/401: Verify Integration Key (plugin) or App Password (fallback).
Plugin not detected: Ensure the plugin is activated and the Integration Key is saved.
Draft URL: Draft posts show ?p=ID links until published—this is normal.

Security

Token-based publishing (plugin) is preferred over Basic Auth.
We recommend rotating plugin Integration Keys periodically.
Hide system errors from users and show friendly messages.

Changelog (highlights)

1.0.0: Initial public plugin release; token-based publishing; docs page added.