Facebook Groups Webhook Integration

With the Groups Watcher Pro plan, new posts from the Facebook groups and pages you monitor are sent to a webhook URL you provide—a straightforward integration for your app, script, or automation. We send the group name, post text, links, and related details with each update. Most alerts arrive in under 60 seconds.

This feature is available on the Pro plan. Check pricing here.

Test your webhook

Before or after configuring your endpoint, open Send test webhook. Pick the sample that matches your setup (single post or batched), enter your webhook URL, and we send a test POST so you can confirm everything works.

Request

• Method: POST
• Headers: Content-Type: application/json
• Body: Structured JSON with either message + data (single post), or message + posts + top-level timestamp when keywords/AI are disabled and your webhook receives all posts in one request.

Payload

Use the sections below for the two custom webhook formats. Other channels (Slack, Discord, etc.) use their own payloads; this page focuses on your own HTTP endpoint.

Single post per request (default)

When your custom webhook is set to receive filtered posts (keywords and/or AI validation), each POST includes a short message and one data object. Map fields like data.group_name, data.post_url, and data.body.

{
  "message": "<string>",
  "data": {
    "group_name": "<string>",
    "group_id": "<string>",
    "poster_name": "<string>",
    "poster_url": "<string>",
    "post_url": "<string>",
    "group_url": "<string>",
    "post_id": "<string>",
    "post_type": "regular_post" | "marketplace",
    "body": "<string>",
    "images": ["<url>", ...],
    "videos": ["<url>", ...],
    "timestamp": "<ISO 8601 string>"
  }
}

This is the default webhook format and is sent one post at a time.

Batched posts (keywords disabled)

When you disable keywords in your campaign, we send webhook alerts in batches, so one request can include multiple posts in a posts array.

{
  "message": "2 new posts in your groups",
  "posts": [
    {
      "group_name": "<string>",
      "group_id": "<string>",
      "group_url": "<string>",
      "poster_name": "<string>",
      "poster_url": "<string>",
      "post_url": "<string>",
      "post_id": "<string>",
      "post_type": "regular_post" | "marketplace",
      "body": "<string>",
      "images": ["<url>", ...],
      "videos": ["<url>", ...],
      "timestamp": "<ISO 8601 string>"
    }
  ],
  "timestamp": "<ISO 8601 string>"
}

Field reference (data object)

In batched mode, each object in posts uses the same keys shown for data above (group_name, post_url, body, etc.), plus a per-item timestamp.

Examples

regular post (with images)

{
  "message": "New post in Tampa Bay Homeowners",
  "data": {
    "group_name": "Tampa Bay Homeowners",
    "group_id": "123456789",
    "poster_name": "Maria Johnson",
    "poster_url": "https://facebook.com/maria.johnson",
    "post_url": "https://www.facebook.com/groups/123456789/permalink/987654321012345/",
    "group_url": "https://www.facebook.com/groups/123456789",
    "post_id": "987654321012345",
    "post_type": "regular_post",
    "body": "Anyone have a good HVAC person in St. Pete? Our AC went out last night",
    "images": ["https://scontent.xx.fbcdn.net/v/.../image1.jpg", "https://.../image2.jpg"],
    "videos": [],
    "timestamp": "2026-02-11T14:30:00.000Z"
  }
}

Example: n8n (Slack, Email, SMS, Discord)

You can use the webhook payload in n8n in several ways: post to Slack, send an email, send an SMS via Twilio, and post to Discord. Build a workflow with a Webhook trigger, then add the branches you need. Save the workflow in n8n before testing the webhook URL.

Frequently asked questions