Notion to Slack: Content Approvals Integration Guide

Comparison matrix

ROI metrics

Automating approvals across a 10-person team eliminates 35 monthly hours of manual tracking, generating over $18,000 in recovered capacity for an annual software investment of $2,250.

Step-by-step setup guide

1. 1.Create Notion Internal Integration

   Navigate to notion.so/my-integrations, click 'New integration', label it 'Content Approval Bot', and select the target workspace. Copy the generated Internal Integration Secret.

   curl -X GET https://api.notion.com/v1/users/me \
     -H "Authorization: Bearer secret_live_notion_api_token" \
     -H "Notion-Version: 2022-06-28"

2. 2.Configure Content Database Schema

   In Notion, create a database named 'Editorial Pipeline'. Add properties: 'Title' (title), 'Author' (person), 'Status' (select: Draft, In Review, Approved, Rejected), and 'Slack_TS' (text). Share the database explicitly with the integration.

3. 3.Provision Slack App with Incoming Webhooks and Scopes

   Create an application at api.slack.com/apps. Under OAuth & Permissions, add 'chat:write' and 'incoming-webhook' bot scopes. Install the app to your workspace and extract the 'xoxb-' token and target channel ID (e.g., #content-reviews).

4. 4.Dispatch Approval Card to Slack via Block Kit

   When a Notion page status updates to 'In Review', trigger a POST request to Slack's chat.postMessage endpoint containing actionable review buttons referencing the Notion page ID.

   curl -X POST https://slack.com/api/chat.postMessage \
     -H "Authorization: Bearer xoxb-slack-bot-token" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d '{"channel":"C0123456789","blocks":[{"type":"section","text":{"type":"mrkdwn","text":"*New Content Ready for Review:* <https://notion.so/p-123|Q3 Product Launch Brief>"}},{"type":"actions","block_id":"approval_actions","elements":[{"type":"button","text":{"type":"plain_text","text":"Approve"},"style":"primary","value":"approve_page_123"},{"type":"button","text":{"type":"plain_text","text":"Reject"},"style":"danger","value":"reject_page_123"}]}]}'

5. 5.Handle Slack Interaction and Update Notion Status

   Set your Slack Interactive Request URL to your middleware listener. When an editor clicks 'Approve', parse the payload, extract the Notion Page ID, and update the Notion status property to 'Approved'.

   curl -X PATCH https://api.notion.com/v1/pages/8a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d \
     -H "Authorization: Bearer secret_live_notion_api_token" \
     -H "Notion-Version: 2022-06-28" \
     -H "Content-Type: application/json" \
     -d '{"properties":{"Status":{"select":{"name":"Approved"}}}}'

Webhook payload example

{
  "id": "evt_9b8a7c6d5e4f3a2b",
  "event": "page.created",
  "timestamp": 1698150400,
  "data": {
    "object": "page",
    "id": "8a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    "parent": {
      "type": "database_id",
      "database_id": "d3b07384-d113-40a2-9e28-1f6d338e55e8"
    },
    "url": "https://www.notion.so/Q3-Product-Launch-Brief-8a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d",
    "properties": {
      "Title": {
        "title": [
          {
            "plain_text": "Q3 Product Launch Brief"
          }
        ]
      },
      "Author": {
        "people": [
          {
            "id": "usr_c9a1e0b2",
            "name": "Sarah Chen",
            "person": {
              "email": "sarah@company.com"
            }
          }
        ]
      },
      "Status": {
        "select": {
          "id": "stat_in_review",
          "name": "In Review",
          "color": "yellow"
        }
      }
    }
  }
}

FAQ