docs: Add Bubble integration docs for workflows and notifications #1721

daveomri · 2025-07-24T14:15:05Z

Summary

Created new Bubble integration documentation for the workflows-and-notifications directory, enabling users to automate workflows and set up notifications using Apify Actors within Bubble applications.

What's Added

New Bubble integration guide: Complete documentation covering installation, configuration, and workflow automation
Structured workflow examples: Practical use cases including price monitoring, lead generation, and content aggregation
Proper scope alignment: Focused on workflow automation and notifications to match the directory's purpose
Consistent formatting: Follows the same structure and length as other integration docs in the directory (90 lines, matching the 44-143 line range)
Technical accuracy:
- Correct API token storage practices (User data type with Privacy rules)
- Accurate data call descriptions (List User Tasks, List Actor Runs, List Store Actors)
- Proper Bubble development terminology and best practices

Key Features Documented

Plugin installation from Bubble marketplace
API token configuration and security
Automated workflow triggers (form submissions, scheduled events, etc.)
Data display and management
Troubleshooting common issues

Context

This documentation is being created by DXHeroes and Applifting as part of developing the official Bubble plugin for Apify. The guide enables no-code developers to integrate Apify's web scraping and automation capabilities directly into their Bubble applications.

Testing

Verified all internal links work correctly
Confirmed image references point to existing files
Reviewed content accuracy for Bubble development practices
Ensured consistency with other workflow integration docs

…token storage instructions

TC-MO

Reformatted the text
Changed structure slightly
Lowered reliance on ordered & unordered lists

sources/platform/integrations/workflows-and-notifications/bubble.md

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

daveomri · 2025-08-22T08:21:58Z

@drobnikj Not sure if I'm able to add you as a reviewer to this PR myself, so I'm tagging you in this comment.

TC-MO · 2025-08-22T09:01:24Z

I've added @drobnikj as reviewer :)

drobnikj

The docs look good, I have a few comment, mainly about generic content of some section

Trigger Actor runs from Bubble events
Display Apify data in your application
Automate data collection workflows

Could you please add more info how to set up, I see there only final screenshot of finish setup, but as an user I need to know how to get there.

sources/platform/integrations/workflows-and-notifications/bubble.md

drobnikj · 2025-08-28T14:32:49Z

sources/platform/integrations/workflows-and-notifications/bubble.md

+description: Learn how to integrate your Apify Actors with Bubble for automated workflows and notifications.
+sidebar_label: Bubble
+sidebar_position: 7
+slug: /integrations/bubble


Can you somehow reference the demo app apify-28595.bubbleapps.io/version-test ?
It deserves its own caption, as it could help users to get into it.

drobnikj · 2025-08-28T14:34:12Z

sources/platform/integrations/workflows-and-notifications/bubble.md

+After installing the plugin, you'll need to provide your API token when setting up Apify actions:
+
+1. You can find your API token in the Apify Console under **Settings > API & Integrations**.
+2. For security, store your API token in your User data type with Privacy rules applied rather than entering it directly in each API call.


Can you iterate about this step, not sure how to do it, screenshot would help.

or some related doc in bubble

I tried to make it clearer. I mentioned how to set it up and how to use it. Tomorrow i will also link some bubble docs, so the user has enough info to follow the guide.

drobnikj · 2025-08-28T14:38:25Z

sources/platform/integrations/workflows-and-notifications/bubble.md

+
+### Trigger Actor runs from Bubble events
+
+Create workflows that run Apify Actors in response to events in your Bubble app, such as button clicks or form submissions. In the **Workflow** tab, set up a new workflow with your chosen trigger event. Add a new action and select **Run Actor** or **Run Actor Task** from the Apify plugin. Configure the Actor or Task, including any input data, and include follow-up actions to process the returned data.


This is really a generic guide. Can you provide more guidenece here?

how to set up token into API call

Where to copy actorId and use it in API call

How to use input from some field into actor input.

where tha Apify plugins could be find

Tried to make it clearer, let me know if you would add/remove anything from the current version. I will review it again tomorrow to ensure everything makes sense.

drobnikj · 2025-08-28T14:47:42Z

sources/platform/integrations/workflows-and-notifications/bubble.md

+
+### Display Apify data in your application
+
+Populate elements in your Bubble application with information from your Apify account or Actor run data. Apply data sources like **List User Tasks**, **List Actor Runs**, or **List Store Actors** to repeating groups. To show actual scraped data, use **Fetch Data From Dataset Json As Data** to retrieve results from your run's dataset.


This is very generic, not sure if the user based this would be able to set it up, could you iterate over it.

Tried to expand this part as well. Please let me know if you would like to add anything to it.

sources/platform/integrations/workflows-and-notifications/bubble.md

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

TC-MO

Last few things I noticed, after that it should be fine

TC-MO · 2025-09-02T17:10:34Z

sources/platform/integrations/workflows-and-notifications/bubble.md

+   - For example `Run Actor` (run a specific Actor by ID)
+   - ![Add action to workflow](../images/bubble/add_action_to_workflow.png)
+1. Configure the action:
+   - **API token**: set to `Current User's apify_api_token` (check out the Step 2.3)


Step 2.3 no longer exists.
Also I feel like indentation is weird 3 spaces and it should be 2 (but this I think refers to whole document)

I had set 3 as default..., not sure why, but I fixed it in the previous commit.

sources/platform/integrations/workflows-and-notifications/bubble.md

TC-MO · 2025-09-02T17:19:22Z

sources/platform/integrations/images/bubble/user_dataset_repeating_group_source.png

Is this yellow rectangle added as highlight? Our style guide calls for red indicators. If this is to highlight, can it be accomodated to fit style guide?

No, this is how Bubble displays it. The same goes for text highlighting.

Cool, thanks for clarification!

TC-MO

LGTM

cursor

This PR is being reviewed by Cursor Bugbot

Details

Your team is on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle for each member of your team.

To receive Bugbot reviews on all of your PRs, please have a team admin upgrade your team to Bugbot Pro by visiting the Cursor dashboard. Your first 14 days will be free!

Comment @cursor review or bugbot run to trigger another review on this PR

sources/academy/webscraping/puppeteer_playwright/executing_scripts/injecting_code.md

daveomri · 2025-09-03T08:43:01Z

@TC-MO sorry, I accidentally pushed rebase into my master, which caused the owners of the code rebased to be add as reviewers... 😅 I reversed it to the last commit, so it should be as before, but with new reviewers added to this pr.

TC-MO

These changes will fix markdownlint and prepare us for merge

sources/platform/integrations/workflows-and-notifications/bubble.md

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

daveomri added 6 commits July 23, 2025 13:08

feat: add Bubble integration documentation and related images

35fa03e

docs: enhance Bubble integration documentation with additional images

5ccf318

docs: updated the Bubble integration doc

4f3b402

docs: update Bubble integration images and content

36940b1

docs: add additional images to Bubble integration documentation

ab939a2

docs: update Bubble integration documentation with new image and API …

d21fb2c

…token storage instructions

daveomri requested a review from TC-MO as a code owner July 24, 2025 14:15

daveomri changed the title ~~Add Bubble integration docs for workflows and notifications~~ docs: Add Bubble integration docs for workflows and notifications Jul 24, 2025

TC-MO requested changes Aug 4, 2025

View reviewed changes

daveomri and others added 11 commits August 18, 2025 09:55

Update sources/platform/integrations/workflows-and-notifications/bubb…

72b40b2

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

680cbde

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

50c0457

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

946dce4

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

d60a869

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

f7073fb

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

7b5dfb1

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

56e1a2f

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

fbf25f5

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

922d862

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

035ef64

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

daveomri requested a review from TC-MO August 19, 2025 07:57

TC-MO requested a review from drobnikj August 22, 2025 09:01

TC-MO approved these changes Aug 25, 2025

View reviewed changes

drobnikj requested changes Aug 28, 2025

View reviewed changes

daveomri added 2 commits September 1, 2025 18:25

feat: updated bubble integration images and documentation

ee9435e

chore: removed redundant info, checked info in the text

86be24a

daveomri requested review from drobnikj and TC-MO September 2, 2025 07:37

daveomri and others added 5 commits September 2, 2025 17:12

Update sources/platform/integrations/workflows-and-notifications/bubb…

f8ffb9c

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

fadb4ae

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

f308b07

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

chore: edited bubble docs

16a904a

chore: addressed the notes, added link to bubble integration

9d0a237

TC-MO requested changes Sep 2, 2025

View reviewed changes

TC-MO reviewed Sep 2, 2025

View reviewed changes

daveomri added 2 commits September 3, 2025 08:19

fix: changed tab spaces from 3 to 2

c9f1f36

fix: fixed formatting and added space after title

8f70a06

daveomri requested a review from TC-MO September 3, 2025 06:57

TC-MO approved these changes Sep 3, 2025

View reviewed changes

daveomri requested review from janbuchar, fnesveda, honzajavorek and mnmkng as code owners September 3, 2025 08:30

cursor bot reviewed Sep 3, 2025

View reviewed changes

sources/academy/webscraping/puppeteer_playwright/executing_scripts/injecting_code.md Show resolved Hide resolved

daveomri force-pushed the master branch from ff41a64 to 8f70a06 Compare September 3, 2025 08:37

Merge branch 'master' into master

ff3e960

TC-MO approved these changes Sep 3, 2025

View reviewed changes

daveomri and others added 5 commits September 3, 2025 10:55

Update sources/platform/integrations/workflows-and-notifications/bubb…

1516899

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

8b09fe2

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

b429053

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

85e18d3

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/integrations/workflows-and-notifications/bubb…

2ed2af7

…le.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

drobnikj removed request for honzajavorek, fnesveda, mnmkng and janbuchar September 3, 2025 09:02

drobnikj merged commit 1bc783a into apify:master Sep 3, 2025
8 of 9 checks passed


		### Trigger Actor runs from Bubble events

		Create workflows that run Apify Actors in response to events in your Bubble app, such as button clicks or form submissions. In the Workflow tab, set up a new workflow with your chosen trigger event. Add a new action and select Run Actor or Run Actor Task from the Apify plugin. Configure the Actor or Task, including any input data, and include follow-up actions to process the returned data.


		### Display Apify data in your application

		Populate elements in your Bubble application with information from your Apify account or Actor run data. Apply data sources like List User Tasks, List Actor Runs, or List Store Actors to repeating groups. To show actual scraped data, use Fetch Data From Dataset Json As Data to retrieve results from your run's dataset.

docs: Add Bubble integration docs for workflows and notifications #1721

docs: Add Bubble integration docs for workflows and notifications #1721

Uh oh!

Conversation

daveomri commented Jul 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

What's Added

Key Features Documented

Context

Testing

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

daveomri commented Aug 22, 2025

Uh oh!

TC-MO commented Aug 22, 2025

Uh oh!

drobnikj left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

This PR is being reviewed by Cursor Bugbot

Uh oh!

Uh oh!

daveomri commented Sep 3, 2025

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

daveomri commented Jul 24, 2025 •

edited

Loading