Getting Started

Quick Start Guide

Get from zero to your first published AI blog post in under 10 minutes. This guide walks you through creating an account, connecting your website, and publishing your first SEO-optimized post with Blogree.

What you'll accomplish
1. Create a free Blogree account
2. Connect your first website
3. Let AI detect your niche
4. Pick a trending topic
5. Generate an AI blog post
6. Publish or schedule it live

Prerequisites

Before you begin, make sure you have:

  • A website or blog you want to publish content to (any platform — Next.js, WordPress, custom)
  • Node.js 18+ installed if connecting a JavaScript-based site
  • Admin access to your website to install the webhook handler
✅
Don't have a website yet? You can still explore the Blogree dashboard and create posts. Connect a site later when you're ready to publish.

Steps

1

Create Your Free Account

Go to blogree.com/signup and create your account. No credit card required for the free Starter plan.

You'll be asked for your name, email, and a password. After verifying your email, you're taken straight to the dashboard.

✅
The Starter plan gives you 2 connected websites and 5 AI posts per month — enough to test the full workflow before upgrading.
2

Add Your Website

In the left sidebar, click Sites → Add Site. Enter your website's URL and give it a name (e.g. "My Tech Blog").

Blogree will generate an API Key and a Webhook Secret for this site. Copy both — you'll need them in the next step.

# Your site credentials (shown after adding site) BLOGREE_API_KEY=bk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx BLOGREE_API_URL=https://api.blogree.com BLOGREE_WEBHOOK_SECRET=whs_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
3

Install the Webhook Handler on Your Site

Blogree delivers posts to your site via signed webhooks. Install the handler for your platform:

Next.js (App Router)

npm install @blogree/nextjs-adapter
// app/api/blogree/route.ts import { createWebhookHandler } from '@blogree/nextjs-adapter'; import { revalidatePath } from 'next/cache'; export const POST = createWebhookHandler( { apiKey: process.env.BLOGREE_API_KEY!, apiUrl: process.env.BLOGREE_API_URL!, webhookSecret: process.env.BLOGREE_WEBHOOK_SECRET!, }, async (payload) => { // Revalidate pages after new post is delivered revalidatePath('/blog'); revalidatePath(`/blog/${payload.post.slug}`); } );

WordPress

Install the Blogree WordPress plugin from the WordPress plugin directory, or manually add the webhook URL in Settings → Blogree → Webhook URL. See the WordPress integration guide for full details.

Other platforms

For Gatsby, SvelteKit, Astro, Hugo, or any custom platform, see the Custom Webhook guide. All platforms just need an HTTP endpoint that accepts POST requests.

4

Set the Webhook URL in Blogree

Back in the Blogree dashboard, go to Sites → your site → Settings and enter your webhook URL:

# Next.js App Router: https://yourdomain.com/api/blogree # Next.js Pages Router: https://yourdomain.com/api/blogree/revalidate # WordPress: https://yourdomain.com/?blogree_webhook=1 # Custom endpoint: https://yourdomain.com/your-webhook-endpoint

Click Test Delivery to send a sample payload and verify your endpoint is working. You should see a 200 OK response in the test result panel.

5

Discover Trending Topics

Now the fun begins. Navigate to Posts → New Post. At the top, you'll see Trending Topics — a curated list of high-traffic, low-competition blog ideas tailored to your site's detected niche.

Click any topic to select it as your post topic, or type your own custom topic in the text field below the suggestions.

💡
Niche detection runs automatically when you add your site. If your site is new or has limited content, you can manually set your niche in Sites → your site → Niche Settings.
6

Generate or Write Your Post

With your topic selected, choose how you want to create the post:

  • Generate with AI — Click the Generate Post button. Blogree's AI creates a full 1,500–3,000 word SEO-structured post in about 15 seconds, including title, meta description, headings, body content, and OG metadata.
  • Write manually — Click Write from Scratch to open the rich text editor. Type your content with full formatting support: headings, bold, italic, lists, code blocks, images, and more.

Either way, you can edit the post in the rich editor before publishing — the AI draft is just a starting point.

7

Publish or Schedule

When your post is ready, select which site(s) to publish to using the site selector in the top-right of the editor. Then choose:

  • Publish Now — Immediately dispatches a signed webhook to your site. Your site receives the post and revalidates the relevant pages.
  • Schedule — Pick a future date and time. Blogree will automatically publish it at that moment, even if you're offline.

After publishing, you'll see real-time delivery status in the Analytics section showing whether the webhook was successfully delivered to each site.

✅
🎉 That's it! Your first AI blog post is live. Head to your site's blog page and refresh — you should see the new post.

What's Next?