Admin · 5 min

Setting Up Notion

Connect HushAsk to Notion and turn closed public threads into permanent, searchable records in your Hush Library database — with a summary title you set each time.

How to connect

Open the HushAsk App Home tab in Slack. In the Configuration section (visible to admins only), click Connect Notion. This opens a browser OAuth flow — authorize HushAsk in your Notion workspace and we'll automatically provision the Hush Library database. No tokens, no page IDs. Done in under a minute.

If OAuth isn't available in your deployment, the Configuration section will show token and database ID fields instead. Create an internal Notion integration, share a database with it, and paste the credentials in. Steps below →

What gets created in Notion

When you first connect, HushAsk provisions a Hush Library database in your Notion workspace with these properties:

Name — the summary title you enter when archiving a thread
Route — Public or Confidential / HR (Select)
Status — New → Answered → Archived (Select)
Full message body as page content

Sync is intentional, not automatic. Notion entries are only created when an admin closes a Public thread using "Close & Sync to Notion". Your Hush Library stays clean and curated — not a raw feed of every message received.

How archiving works

Admin closes a Public thread — click "Close & Sync to Notion" on the triage message
Set a summary title — an "Archive This Thread" modal opens. Enter a clear, searchable title (e.g. "How do I request PTO during blackout periods?")
Entry created in Notion — HushAsk creates the page with the title, route, status "New", and full message body

Manual token setup (fallback)

Create an internal Notion integration — go to notion.so/my-integrations → New integration → Internal → name it "HushAsk" → Save. Copy the token (starts with secret_).
Create a Hush Library database — new full-page database with Route (Select) and Status (Select) properties.
Share the database with your integration — ••• → Add connections → HushAsk integration → Confirm.
Copy the Database ID — the 32-character ID from the database URL.
Paste credentials into App Home — Configuration section → paste token and database ID → Save.

Troubleshooting

"object_not_found" after OAuth — provisioning failed. Reconnect or use manual setup.
Sync fails: "unauthorized" — OAuth token expired. Reconnect via App Home.
Sync fails: "Could not find database" — database not shared with integration. Re-share it.