Documentation

Connect BlogFlux.ai to your WordPress site using the native WordPress REST API. Our integration automatically handles authentication, post creation, and metadata optimization.

Setup Steps:

1. Navigate to "Blog Connections" in your dashboard
2. Click "Connect WordPress Site"
3. Enter your WordPress site URL (e.g., https://yourblog.com)
4. Provide your WordPress username and application password
5. Test the connection and save

Connect BlogFlux.ai to any custom CMS, headless platform, or HTTP-enabled system using webhooks. When a post is generated, BlogFlux.ai will send a POST request to your webhook URL with the complete post data.

Setup Steps:

1. Navigate to "Blog Connections" in your dashboard
2. Click "Connect via Webhook"
3. Enter your webhook URL (must be HTTPS)
4. Optionally add custom headers for authentication (e.g., API keys)
5. Test the webhook and save

Webhook Payload:

{
  "id": 456,
  "title": "Your Post Title",
  "content": "<p>Full HTML content with embedded images...</p>",
  "content_markdown": "## Full Markdown source of the same post...",
  "meta_description": "SEO meta description (max 160 chars)",
  "slug": "your-post-title",
  "keywords": ["keyword1", "keyword2", "keyword3"],
  "status": "published",
  "featured_image_url": "https://storage.example.com/featured-image.jpg",
  "images": [
    {
      "url": "https://storage.example.com/image-1.jpg",
      "alt_text": "Description of first image",
      "position": 0,
      "caption": "Optional caption for image"
    },
    {
      "url": "https://storage.example.com/image-2.jpg",
      "alt_text": "Description of second image",
      "position": 1,
      "caption": null
    }
  ],
  "images_count": 2,
  "scheduled_for": "2025-11-10T14:00:00Z",
  "ai_model_used": "gpt5_mini",
  "created_at": "2025-11-06T10:30:00Z",
  "updated_at": "2025-11-06T10:30:00Z"
}

Expected Response:

Your webhook endpoint should return a 200-299 HTTP status code to confirm successful receipt. Example:

{
  "success": true,
  "post_id": "12345",
  "url": "https://yourblog.com/posts/post-slug"
}

BlogFlux.ai provides a comprehensive REST API for developers who want to integrate AI content generation into their applications. Our API supports all core features available in the web interface.

Interactive Documentation:

Access our complete, interactive API documentation built with Swagger/OpenAPI:

View API Documentation

Getting Your API Key:

All API requests require authentication using an API key. Follow these steps to generate your API key:

1. Log in to your account - You must be signed in to generate API keys
2. Navigate to API Keys - Click on your profile menu (top right) and select "API Keys", or click here to go directly
3. Generate a new key - Click the "Generate New API Key" button
4. Copy your key immediately - The full API key is only shown once. Copy it and store it securely
5. Use in your requests - Include the key in the Authorization header of all API requests

Authentication:

Include your API key in the Authorization header of every request using the Bearer token format:

Authorization: Bearer YOUR_API_KEY

Core Endpoints:

curl -X POST https://blogflux.ai/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "AI Content Generation Best Practices",
    "keywords": ["AI writing", "SEO", "content marketing"],
    "tone": "professional",
    "word_count": 1500,
    "blog_connection_id": 123
  }'

{
  "status": "success",
  "data": {
    "post": {
      "id": 456,
      "title": "AI Content Generation Best Practices: A Complete Guide",
      "content": "<p>Full HTML content...</p>",
      "meta_description": "Learn the best practices...",
      "keywords": ["AI writing", "SEO", "content marketing"],
      "status": "draft",
      "word_count": 1523,
      "created_at": "2025-11-01T22:00:00Z"
    }
  }
}