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 a670b423) 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>

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

Comment thread sources/platform/integrations/crm/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

Draft


		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