feat: hubspot integration docs by protoss70 · Pull Request #2626 · apify/apify-docs

protoss70 · 2026-06-09T14:11:59Z

Create user facing documentation for our new HubSpot integration

apify-service-account · 2026-06-09T14:12:46Z

✅ Preview for this PR (commit fb66b463) is ready at https://pr-2626.preview.docs.apify.com (see action run).

marcel-rbro

Also, I'd just keep this page in the workflows section for now. I'll be reworking the integrations section, there's no need to create a new category for one page.

marcel-rbro · 2026-06-16T08:20:06Z

+
+import ThirdPartyDisclaimer from '@site/sources/_partials/_third-party-integration.mdx';
+
+With the Apify integration for [HubSpot](https://www.hubspot.com/), you can enrich your CRM with business contacts scraped from company websites. The integration runs as a CRM card inside your HubSpot portal, uses Apify's Contact Details Scraper to extract contacts, and writes results back as HubSpot contacts automatically.


Link the Actor on first mention.

Suggested change

With the Apify integration for [HubSpot](https://www.hubspot.com/), you can enrich your CRM with business contacts scraped from company websites. The integration runs as a CRM card inside your HubSpot portal, uses Apify's Contact Details Scraper to extract contacts, and writes results back as HubSpot contacts automatically.

With the Apify integration for [HubSpot](https://www.hubspot.com/), you can enrich your CRM with business contacts scraped from company websites. The integration runs as a CRM card inside your HubSpot portal, uses Apify's [Contact Details Scraper](https://apify.com/vdrmota/contact-info-scraper) to extract contacts, and writes results back as HubSpot contacts automatically.

marcel-rbro · 2026-06-16T08:20:06Z

+1. Find the **Apify** app in the HubSpot Marketplace (or use the install link provided by your Apify contact).
+2. Click **Install**. This starts a two-step OAuth authorization:
+   - **Step 1:** Authorize HubSpot to share your CRM data with Apify (contacts, companies, properties).
+   - **Step 2:** You are redirected to Apify Console to authorize your Apify account.
+3. On success, you see an installation confirmation page.


Use 1. for every item; Select not Click for UI actions.

Suggested change

1. Find the **Apify** app in the HubSpot Marketplace (or use the install link provided by your Apify contact).

2. Click **Install**. This starts a two-step OAuth authorization:

- **Step 1:** Authorize HubSpot to share your CRM data with Apify (contacts, companies, properties).

- **Step 2:** You are redirected to Apify Console to authorize your Apify account.

3. On success, you see an installation confirmation page.

1. Find the **Apify** app in the HubSpot Marketplace (or use the install link provided by your Apify contact).

1. Select **Install**. This starts a two-step OAuth authorization:

- **Step 1:** Authorize HubSpot to share your CRM data with Apify (contacts, companies, properties).

- **Step 2:** You are redirected to Apify Console to authorize your Apify account.

1. On success, you see an installation confirmation page.

marcel-rbro · 2026-06-16T08:20:06Z

+1. In HubSpot, go to **CRM** > **Contacts** (or **Companies**).
+2. Open any contact or company record.
+3. Click the **Customize** button on the right side of the record page.
+4. Select the **Default view**.
+5. Click **Add card**, then go to the **Card Library**.
+6. Search for **Apify** and click **Add card**.


Use 1. for every item; Select not Click.

Suggested change

1. In HubSpot, go to **CRM** > **Contacts** (or **Companies**).

2. Open any contact or company record.

3. Click the **Customize** button on the right side of the record page.

4. Select the **Default view**.

5. Click **Add card**, then go to the **Card Library**.

6. Search for **Apify** and click **Add card**.

1. In HubSpot, go to **CRM** > **Contacts** (or **Companies**).

1. Open any contact or company record.

1. Select the **Customize** button on the right side of the record page.

1. Select the **Default view**.

1. Select **Add card**, then go to the **Card Library**.

1. Search for **Apify** and select **Add card**.

marcel-rbro · 2026-06-16T08:20:06Z

+
+## Create a lead enrichment
+
+Click the **+ Add Lead Enrichment** button in the Apify card to open the configuration wizard.


Use Select not Click.

Suggested change

Click the **+ Add Lead Enrichment** button in the Apify card to open the configuration wizard.

Select the **+ Add Lead Enrichment** button in the Apify card to open the configuration wizard.

marcel-rbro · 2026-06-16T08:20:07Z

+
+If the current company has no website URL in its HubSpot record, a warning dialog appears with two options:
+
+- **Update the HubSpot record** - edit the company in HubSpot, then click **Check again**.


Use select not click.

Suggested change

- **Update the HubSpot record** - edit the company in HubSpot, then click **Check again**.

- **Update the HubSpot record** - edit the company in HubSpot, then select **Check again**.

marcel-rbro · 2026-06-16T08:20:07Z

+- Error message (if the run failed).
+- Per-company breakdown -Created, Updated, Skipped, and Error counts per company (up to 5 companies displayed).
+- Companies in run -list of company domains included.
+- Field mappings used -the exact mappings that were applied.


Missing space after hyphen.

Suggested change

- Field mappings used -the exact mappings that were applied.

- Field mappings used - the exact mappings that were applied.

marcel-rbro · 2026-06-16T08:20:07Z

+
+### Abort a run
+
+While a run is in progress, an **Abort** button appears next to the status badge. Clicking it stops both the scraper and data-import processes and marks the run as errored with "Aborted by user."


Use Selecting not Clicking.

Suggested change

While a run is in progress, an **Abort** button appears next to the status badge. Clicking it stops both the scraper and data-import processes and marks the run as errored with "Aborted by user."

While a run is in progress, an **Abort** button appears next to the status badge. Selecting it stops both the scraper and data-import processes and marks the run as errored with "Aborted by user."

marcel-rbro · 2026-06-16T08:20:07Z

+
+Only one run can be active per config. Starting a new run while one is in progress will show an error.
+
+Click the info icon on any completed run to see detailed statistics, including rows total, created/updated/skipped counts, per-company breakdown, and links to the scraper and import runs on Apify Console.


Use Select not Click.

Suggested change

Click the info icon on any completed run to see detailed statistics, including rows total, created/updated/skipped counts, per-company breakdown, and links to the scraper and import runs on Apify Console.

Select the info icon on any completed run to see detailed statistics, including rows total, created/updated/skipped counts, per-company breakdown, and links to the scraper and import runs on Apify Console.

marcel-rbro · 2026-06-16T08:20:08Z

+
+### How do I uninstall?
+
+Remove the Apify app from your HubSpot account through HubSpot's app management settings. Your enriched contact data remains in HubSpot -only the app connection is removed.


Missing space after hyphen.

Suggested change

Remove the Apify app from your HubSpot account through HubSpot's app management settings. Your enriched contact data remains in HubSpot -only the app connection is removed.

Remove the Apify app from your HubSpot account through HubSpot's app management settings. Your enriched contact data remains in HubSpot - only the app connection is removed.

marcel-rbro · 2026-06-16T08:20:08Z

+- Edit the company record in HubSpot and add the website URL, then click **Check again**.
+- Or enter a temporary URL in the card for this enrichment only.
+
+A company without a website cannot be enriched -the scraper needs a URL to visit.


Missing space after hyphen.

Suggested change

A company without a website cannot be enriched -the scraper needs a URL to visit.

A company without a website cannot be enriched - the scraper needs a URL to visit.

Reverts the workflow-automation/ai-assistants/collaboration/data-pipelines/ vector-db-storage/crm split. Keeps the original five top-level sections and tightens them: workflows-and-notifications/ stays as one bin, and data-storage/ is renamed data-and-storage/ to absorb CRM-style destinations like the upcoming HubSpot integration. Top-level layout: - actors/ - programming/ - ai/ (with claude/, openai/, google/ provider sub-folders) - workflows-and-notifications/ - data-and-storage/ (was data-storage/, gains airtable and drive, ready to host hubspot once #2626 lands) Vector DBs (Milvus, Pinecone, Qdrant) move back to ai/ alongside the other AI tools. Surface entry points at the top of the integrations sidebar: - integrate-with-apify.md sidebar_position: 1 - actors/_category_.yml position: 2 - programming/_category_.yml position: 3 AI, workflows-and-notifications, and data-and-storage sort alphabetically after these three pinned entries. Landing pages rewritten for the consolidated layout: - ai/index.mdx (new): provider cards (Claude, OpenAI, Google), MCP, agent frameworks, AI assistants, vector DBs, agent payments - workflows-and-notifications/index.mdx (new): featured n8n/Make/Zapier/ Gumloop + full alphabetical card grid - data-and-storage/index.mdx (rewritten): featured Snowflake/Airtable/ Keboola + full grid including Drive; HubSpot mention - programming/index.mdx (new): API, Webhooks, GitHub cards actors/index.md kept as-is (already a full landing page). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

…rage Michal's review on PR #2643: 1. MCP connectors got dropped from the AI landing page when the alphabetical "All AI integrations" grid was removed. Restore it as a featured card next to the MCP server entry - MCP connectors had a recent launch and is a major push. 2. Two featured cards on Data and storage looks sparse. Add Google Drive (native integration). HubSpot will land via #2626. Airbyte and Keboola left for the sidebar because their logos are outdated. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

…2643) Supersedes #2610. Closes #2505. Reorganizes the integrations docs while keeping the original five top-level sections, surfaces audience-specific entry points at the top of the sidebar, and rewrites every landing page around S-tier integrations. ### Five top-level sections (unchanged count) | Section | Sidebar position | Contents | |---|---|---| | `actors/` | pinned (3) | Actor-to-Actor integrations on the platform. Folder relabeled "Actor-to-Actor" so the sidebar tells the reader what's inside (per Tomas Nosek's feedback). | | `programming/` | pinned (4) | API, Webhooks, GitHub. | | `ai/` | alphabetical | AI integrations. Vector DBs (Milvus, Pinecone, Qdrant) live here as flat siblings. New per-provider sub-folders for Claude, OpenAI, and Google, each with its own landing page and per-tool blurbs. | | `data-and-storage/` | alphabetical | Renamed from `data-storage/`. Absorbs Drive + Airtable + the upcoming HubSpot integration. | | `workflows-and-notifications/` | alphabetical | Unchanged structurally; gained a landing page. | ### Surfaced entry points (top of the integrations sidebar) 1. **Overview** (`index.mdx`) 2. **Create new integration** (`integrate-with-apify.md`, `sidebar_position: 1`) - partners building integrations 3. **Apify for AI agents** (`agent-onboarding.md`, `sidebar_position: 2`) - agent builders connecting to Apify (moved up from `ai/`) 4. Actor-to-Actor (position 3) 5. Programming (position 4) 6. AI, Data and storage, Workflows and notifications (alphabetical) ### AI provider sub-folders Inside `ai/`, three new sub-folders group provider-specific pages, each with an `index.mdx` landing page that introduces the provider and gives a short blurb on what each tool does with Apify: - `ai/claude/` - Claude Desktop (moved from `ai/mcp/`) - `ai/openai/` - ChatGPT, OpenAI Agents SDK, OpenAI Assistants - `ai/google/` - Google ADK `ai/mcp/index.md` flattened to `ai/mcp.md` (folder no longer has subpages). ### Sidebar sorting within sections Tier-based `sidebar_position` dropped from every integration page. Within each category, pages sort alphabetically. Tier ranking now surfaces on landing-page card grids, not in the sidebar order. ### Landing pages Every category and provider folder has an `index.mdx` landing page. Each page leads with a verbatim category blurb (reused on the main integrations page so the framing is consistent), shows the S-tier integrations as cards, and links to the sidebar for the full list. The exhaustive alphabetical grids were dropped per follow-up feedback - the sidebar already does that job. The main page (`sources/platform/integrations/index.mdx`) was rewritten around the same per-category structure, plus a "Create a new integration" section explaining the partner-onboarding entry point. ### Logos Fetched logos for cards that were missing one: - From Simple Icons (CC0): Snowflake, Vercel (+ dark variant), Anthropic / Claude (+ dark variant), Google - From brand site: OpenClaw, Agno (PNG saved for future use) - Twemoji glyphs as placeholders for built-in cards that have no brand logo: Actor-to-Actor (🔁), Integration-ready (🔌), API (⚙️), x402 (💸) ### Filename normalization Underscored doc filenames in `sources/platform/integrations/` renamed to hyphens. Slugs left unchanged - URLs do not break. - `integrate_with_apify.md` → `integrate-with-apify.md` - `ai/aws_bedrock.md` → `ai/aws-bedrock.md` - `ai/openai_agents.md` → `ai/openai/openai-agents.md` - `ai/openai_assistants.md` → `ai/openai/openai-assistants.md` - `actors/integration_ready_actors.md` → `actors/integration-ready-actors.md` - `actors/integrating_actors_via_api.md` → `actors/integrating-actors-via-api.md` - `programming/webhooks/ad_hoc_webhooks.md` → `programming/webhooks/ad-hoc-webhooks.md` ### URL impact Zero. All integration pages use flat slugs (`slug: /integrations/<name>`), so moves and renames do not change URLs. `pnpm build` passes (`onBrokenLinks: 'throw'` catches misses). ### Out of scope - HubSpot page itself - lands via #2626. Suggest dropping the `crm/` folder there and placing it directly in `data-and-storage/hubspot.md` before merging. - Moving `actors/integration-ready-actors.md` out of integrations to the Actor development section (Tomas's secondary suggestion - punted to a follow-up to keep this PR focused). - New pages for empty landing-page categories (Coding agents & IDEs, App builders, MCP gateways, iPaaS, GTM). ### Open questions - Confirm the `data-and-storage/` rename and the inclusion of Drive + Airtable + future HubSpot. - AI provider set: starting with Claude, OpenAI, Google. Worth adding Amazon (Bedrock) now, or wait for a second Amazon page? - Provider landing-page slugs (`/integrations/claude`, `/integrations/openai`, `/integrations/google`) - any conflicts I missed? --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Merge master and adapt the HubSpot page to the restructured integrations sidebar (#2643): move it to workflows-and-notifications as a flat sibling, drop the standalone CRM category, and keep it out of the curated landing page card grids. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat: hubspot integration docs

b4fbbaf

protoss70 requested a review from drobnikj June 9, 2026 14:12

protoss70 self-assigned this Jun 9, 2026

protoss70 requested a review from marcel-rbro as a code owner June 9, 2026 14:12

protoss70 added documentation Improvements or additions to documentation. t-integrations Issues with this label are in the ownership of the integrations team. labels Jun 9, 2026

github-actions Bot added this to the 142nd sprint - Integrations team milestone Jun 9, 2026

protoss70 added 3 commits June 9, 2026 17:12

fix: turn images to webp

2b5854a

fix: linting fixes

fc1e7f1

fix: linting fixes

34e1e6c

drobnikj requested changes Jun 10, 2026

View reviewed changes

Comment thread sources/platform/integrations/index.mdx Outdated

Comment thread sources/platform/integrations/workflows-and-notifications/hubspot.md

protoss70 added 2 commits June 11, 2026 14:14

fix: code review fixes

2136ef8

fix: linting fixes

147e1c9

protoss70 requested a review from drobnikj June 11, 2026 12:53

Merge branch 'master' into feat/hubspot-docs

a670b42

marcel-rbro reviewed Jun 16, 2026

View reviewed changes

drobnikj approved these changes Jun 16, 2026

View reviewed changes

marcel-rbro mentioned this pull request Jun 16, 2026

docs: restructure integrations sidebar with category landing pages #2643

Merged


		import ThirdPartyDisclaimer from '@site/sources/_partials/_third-party-integration.mdx';

		With the Apify integration for [HubSpot](https://www.hubspot.com/), you can enrich your CRM with business contacts scraped from company websites. The integration runs as a CRM card inside your HubSpot portal, uses Apify's Contact Details Scraper to extract contacts, and writes results back as HubSpot contacts automatically.


		## Create a lead enrichment

		Click the + Add Lead Enrichment button in the Apify card to open the configuration wizard.

	Click the + Add Lead Enrichment button in the Apify card to open the configuration wizard.
	Select the + Add Lead Enrichment button in the Apify card to open the configuration wizard.


		If the current company has no website URL in its HubSpot record, a warning dialog appears with two options:

		- Update the HubSpot record - edit the company in HubSpot, then click Check again.

	- Field mappings used -the exact mappings that were applied.
	- Field mappings used - the exact mappings that were applied.


		### Abort a run

		While a run is in progress, an Abort button appears next to the status badge. Clicking it stops both the scraper and data-import processes and marks the run as errored with "Aborted by user."


		Only one run can be active per config. Starting a new run while one is in progress will show an error.

		Click the info icon on any completed run to see detailed statistics, including rows total, created/updated/skipped counts, per-company breakdown, and links to the scraper and import runs on Apify Console.

	Click the info icon on any completed run to see detailed statistics, including rows total, created/updated/skipped counts, per-company breakdown, and links to the scraper and import runs on Apify Console.
	Select the info icon on any completed run to see detailed statistics, including rows total, created/updated/skipped counts, per-company breakdown, and links to the scraper and import runs on Apify Console.


		### How do I uninstall?

		Remove the Apify app from your HubSpot account through HubSpot's app management settings. Your enriched contact data remains in HubSpot -only the app connection is removed.

	A company without a website cannot be enriched -the scraper needs a URL to visit.
	A company without a website cannot be enriched - the scraper needs a URL to visit.

Conversation

protoss70 commented Jun 9, 2026

Uh oh!

apify-service-account commented Jun 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

marcel-rbro left a comment • 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!

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!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

apify-service-account commented Jun 9, 2026 •

edited

Loading

marcel-rbro left a comment •

edited

Loading