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 <[email protected]>

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.

drobnikj · 2025-08-28T14:24:17Z

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

+
+To integrate Apify with your Bubble application, you first need to install the Apify plugin from the Bubble plugin marketplace.
+
+![Apify Plugin Download](../images/bubble/plugin_install_preview.png)


This screen had old logo can we update it?

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

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

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.

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

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

+
+![Apify Plugin Download](../images/bubble/plugin_install_preview.png)
+
+1. Go to your Bubble application dashboard and navigate to the **Plugins** tab.


Could you fix indexes?

You mean the 1. in each point in ordered list? This is correct way of doing it, docusaurus will then on build, make numbers proper.

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 <[email protected]>

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

680cbde

…le.md Co-authored-by: Michał Olender <[email protected]>

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

50c0457

…le.md Co-authored-by: Michał Olender <[email protected]>

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

946dce4

…le.md Co-authored-by: Michał Olender <[email protected]>

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

d60a869

…le.md Co-authored-by: Michał Olender <[email protected]>

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

f7073fb

…le.md Co-authored-by: Michał Olender <[email protected]>

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

7b5dfb1

…le.md Co-authored-by: Michał Olender <[email protected]>

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

56e1a2f

…le.md Co-authored-by: Michał Olender <[email protected]>

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

fbf25f5

…le.md Co-authored-by: Michał Olender <[email protected]>

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

922d862

…le.md Co-authored-by: Michał Olender <[email protected]>

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

035ef64

…le.md Co-authored-by: Michał Olender <[email protected]>

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


		To integrate Apify with your Bubble application, you first need to install the Apify plugin from the Bubble plugin marketplace.

		![Apify Plugin Download](../images/bubble/plugin_install_preview.png)


		### 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.


		![Apify Plugin Download](../images/bubble/plugin_install_preview.png)

		1. Go to your Bubble application dashboard and navigate to the Plugins tab.

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

Are you sure you want to change the base?

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!

drobnikj Aug 28, 2025

Choose a reason for hiding this comment

Uh oh!

drobnikj Aug 28, 2025

Choose a reason for hiding this comment

Uh oh!

drobnikj Aug 28, 2025

Choose a reason for hiding this comment

Uh oh!

drobnikj Aug 28, 2025

Choose a reason for hiding this comment

Uh oh!

drobnikj Aug 28, 2025

Choose a reason for hiding this comment

Uh oh!

drobnikj Aug 28, 2025

Choose a reason for hiding this comment

Uh oh!

drobnikj Aug 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

TC-MO Aug 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

daveomri commented Jul 24, 2025 •

edited

Loading

drobnikj Aug 28, 2025 •

edited

Loading

TC-MO Aug 28, 2025 •

edited

Loading