Notion setup guide
| Status | Kind | How you connect |
|---|---|---|
| Coming soon | Other | A Make template or an n8n template |
This guide is coming soon: bubbl3 is still checking it end to end. It shows how Notion will send leads to bubbl3, with nothing to install.
What it does
A Notion database automation can send a webhook when a page is added or changed. Point it at a Make or n8n template and each page becomes (or updates) a bubbl3 contact, signed with your lead source's secret, and can start the source's workflow: for example a sign-up list kept in Notion.
Before you start
- A Notion database with Phone and Email properties, and a Notion plan that includes database automations with webhooks.
- A bubbl3 Lead URL for Notion: in Settings, Integrations, under Lead sources, add a Lead URL source, set its labels, owner, consent setting and workflow, and copy its id (
src_...) and signing secret, which is shown once.
Setup
With Make or n8n
- Import the Make blueprint or the n8n workflow below, and paste the source id and secret where the template says.
- Copy the address of the template's first step (Make: the Webhooks module; n8n: the Webhook node's production URL).
- In the Notion database, add an automation: trigger Page added, action Send webhook to that address, with the properties you want to send.
- Add a test page with a test phone number. The lead shows on the source as received. The template's Lead fields step reads the page's id and its Phone and Email properties; if yours are named differently, change the mapping, and add a name if you want one.
- Turn the scenario on (Make) or activate the workflow (n8n).
Templates
Each template takes Notion's webhook, sets the lead's fields, signs the lead with your lead source's secret and sends it to bubbl3, with Notion's record id as the idempotency key, so a retry is the same lead. It never texts anyone itself: your lead source's consent setting and workflow decide what happens next.
- Make blueprint: in Make, create a scenario, open the … menu, choose Import Blueprint and pick the file.
- n8n workflow: in n8n, open a new workflow, open the … menu, choose Import from File and pick the file.
In the n8n workflow's Webhook node, replace the path replace-with-a-long-random-value with a long random value (a new UUID is fine) before you activate it. Anyone who knows the address can post to it, and the workflow would sign what they post, so the path must be one nobody can guess.
After importing, replace PASTE_THE_SOURCE_ID with your lead source's id and PASTE_THE_SOURCE_SECRET with its signing secret. Anyone who can edit the scenario or workflow can read the secret, so share it only with people who could manage the lead source; rotate the secret in bubbl3 if it leaks.
Data shared
From Notion to bubbl3: the page's id and the properties the automation sends: phone and email, and any others you map.
From bubbl3 to Notion: nothing.
Sending rules that still apply
Notion never texts anyone itself. What it sends bubbl3 can start the lead source's workflow, and every workflow text goes through the same checks as a text you send from bubbl3. Nothing in Notion can turn them off.
- Consent. When you connect Notion or create a lead source, you confirm that everyone you send to bubbl3 has agreed to receive texts from you, so its contacts can be texted straight away. bubbl3 never texts a contact who opted out, and a workspace set to text only opted-in contacts texts only them.
- Opt-out. Replying STOP opts a contact out at once.
- Quiet hours. No texts from 8:00 PM to 9:00 AM in the contact's own time zone (from the phone's area code). A text due then waits until the morning.
- Pacing. Each line texts at most 15 new contacts an hour and 50 a day (fewer while a new line warms up), and spaces texts 20 to 90 seconds apart. A big import or batch is queued and sent as the limits allow, never dropped.
- First messages. Until a contact replies, a text can't include links, photos or files, phone numbers or email addresses, must be 300 characters or fewer, and at most 3 texts go out.
What Notion is told when bubbl3 doesn't send
Notion isn't told when bubbl3 doesn't send a text: the reason shows on the message in bubbl3, and in the message.status webhook if you use one.
| Reason | Code | What you see |
|---|---|---|
| A link before the contact replies | pre_reply_link_blocked | Not sent: "Links can't be sent until the contact replies" |
| A photo or file before the contact replies | pre_reply_media_blocked | Not sent: "Photos and files can't be sent until the contact replies" |
| A phone number before the contact replies | pre_reply_phone_blocked | Not sent: "Phone numbers can't be sent until the contact replies" |
| An email address before the contact replies | pre_reply_email_blocked | Not sent: "Email addresses can't be sent until the contact replies" |
| A first message that is too long | pre_reply_too_long | Not sent: "First messages must be 300 characters or fewer" |
| Too many texts without a reply | pre_reply_message_limit | Not sent: "Already sent 3 texts without a reply. Wait for the contact to reply" |
| The same text to too many people today | identical_text_limit | Not sent: "This exact text went to 20 people from this line today" |
| The line is paused after unanswered texts | unanswered_streak_limit | Not sent: "This line is paused after too many unanswered texts" |
| The contact opted out | contact_opted_out | Not sent: "The contact opted out of texts" |
| The workspace texts only opted-in contacts | consent_required | Not sent: "This workspace only texts contacts who opted in" |
| No line can reach the contact | line_unavailable | Not sent: "bubbl3's line for this contact isn't available" |
| Quiet hours | quiet_hours | Held: "Scheduled for 9:00 AM America/Chicago, quiet hours" |
| The line's daily limit | daily_new_contact_cap | Held: "Scheduled for Oct 15, 9:00 AM America/Chicago: today's limit for this line is reached" |
| The line's hourly limit of new contacts | hourly_new_contact_cap | Held: "Scheduled for 2:00 PM America/Chicago: this hour's limit of new contacts for this line is reached" |
The numbers are the default limits; a line's own limits change them. bubbl3's other checks (no phone number, a number that doesn't match) have their own plain reasons.
Limits and known gaps
- One lead per Notion page id: the same page sent again is the same lead.
- Notion sends a page's properties as typed values; a title or text property (such as a name) is a list of text parts, so map its first part's plain text.
- A page without a phone number is refused with "A lead needs a phone number".
Troubleshooting
- Nothing arrives. Check the automation is on and the template's address is right.
403from bubbl3. Check the source id and secret, and that the source isn't paused.