Webhook Payload Format

When SEOMate publishes to your webhook, it sends a JSON payload with the following structure:

{
  "event": "post.published",
  "timestamp": "2025-01-13T10:30:00.000Z",
  "post": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Your Blog Post Title",
    "content": "# Full markdown content here...",
    "description": "Post description/excerpt",
    "cover_image": "https://example.com/image.jpg",
    "tags": ["seo", "marketing"],
    "published_at": "2025-01-13T10:30:00.000Z",
    "canonical_url": "https://seomate.ai/blog/articlehub/550e8400..."
  },
  "user_id": "user-uuid-here",
  "seomate_url": "https://seomate.ai/blog/articlehub/550e8400..."
}

Step-by-Step Setup

Step 1: Prepare Your Webhook Endpoint

Before configuring SEOMate, ensure your webhook endpoint is ready:

1. Set up an HTTPS endpoint that can receive POST requests
2. Implement JSON parsing to handle the webhook payload
3. Add authentication handling if you want to secure the endpoint
4. Test your endpoint with tools like Postman or curl

Step 2: Access SEOMate Integrations

1. Log in to your SEOMate dashboard
2. Navigate to Settings → Integrations
3. Find the API Webhook card
4. Click Connect

Step 3: Configure Webhook Settings

Fill in the webhook configuration form:

Basic Settings

• Integration Name: A friendly name (e.g., "My Custom CMS")
• Webhook URL: Your endpoint URL (e.g., https://api.example.com/webhooks/seomate)

Authentication Method

Choose one of four authentication options:

Step 4: Advanced Settings (Automatic)

These settings are pre-configured for optimal performance:

• Retry Attempts: 3 attempts with exponential backoff
• Timeout: 30 seconds per request
• Content-Type: application/json
• User-Agent: SEOMate-Webhook/1.0

Step 5: Test Your Webhook

1. Click Test Webhook button
2. SEOMate sends a test payload to your endpoint
3. Wait for the response

Step 6: Save Integration

1. Once the test succeeds, click Save Integration
2. Your webhook is now active and ready to receive blog posts!

Common Use Cases

1. Integration with Automation Platforms

Connect SEOMate to Make.com, Zapier, or n8n:

1. Create a webhook trigger in your automation platform
2. Copy the webhook URL
3. Use it as your SEOMate webhook endpoint
4. Build workflows to process and distribute content

2. Custom CMS Integration

For custom-built content management systems:

// Example Express.js endpoint
app.post("/webhooks/seomate", async (req, res) => {
  const { event, post } = req.body;
 
  if (event === "post.published") {
    // Save to your CMS database
    await db.posts.create({
      title: post.title,
      content: post.content,
      published_at: post.published_at,
    });
 
    res.json({ success: true, id: "your-post-id" });
  }
});

3. Multi-Destination Publishing

Set up multiple webhooks to publish to different platforms simultaneously:

• Production website
• Staging environment
• Content backup system
• Analytics tracking

Delivery Tracking

All webhook deliveries are automatically tracked in your SEOMate dashboard:

1. Go to Settings → Publishing
2. View the Publishing Logs tab
3. Filter by platform = "webhook"
4. See delivery status, attempts, and error messages

Security Headers

SEOMate sends these headers with every webhook request:

• Content-Type: application/json
• User-Agent: SEOMate-Webhook/1.0
• X-SEOMate-Event: post.published
• Your configured authentication header

You can use these headers to validate requests are coming from SEOMate.