React + HubSpot integration

Plandalf has no native HubSpot steps, and React code does not write to HubSpot for you. The app opens the checkout; after payment a Send Webhook step calls HubSpot's contacts API or a function you host. A HubSpot workflow can post to a Plandalf catch URL to start a promo countdown.

1. Render the buying action

   Use a JSX button with data-plandalf-present and a stable container with data-plandalf-mount for inline checkout. Under React Strict Mode prefer an effect that calls sdk.mount() and returns handle.close().

2. Create the HubSpot private app

   Give it the contact write scope, copy its access token and keep that token in Plandalf's step headers or a server function, never in React.

3. Create the sequence

   In Automation, My Sequences choose Plandalf, Checkout Completed and your offer. Pick a real checkout on the Test tab so {{trigger.customer_email}} and {{trigger.customer_name}} have values.

4. Add Send Webhook

   Method POST, URL set to HubSpot's batch upsert for contacts, Authorization: Bearer with your token, and a JSON payload with one input whose id is the email, idProperty is email and properties carry the name.

5. Verify and extend

   Run the test with your own email and open the contact in HubSpot. Then add a refund sequence if a property such as lifecycle stage should change.

• HubSpot lists its Send a webhook workflow action for Data Hub Professional and Enterprise, with POST and GET only. Plandalf's own HubSpot page names Marketing Hub, so confirm in HubSpot.
• HubSpot's batch upsert does not support partial upserts when matching on email, per HubSpot's contacts documentation.
• Send Webhook is not signed and has a 30 second reply window, so protect any relay with a secret header.
• Plandalf cannot confirm that a contact in HubSpot has paid. Use the paid invoice for entitlement decisions.

Does React integrate with HubSpot?

Not as a Plandalf connector. A React app opens the Plandalf checkout, and a Send Webhook step creates or updates the HubSpot contact after payment.

How do I add React buyers to HubSpot?

Build a Checkout Completed sequence with Send Webhook to HubSpot's contacts API, with a private app token in the headers, or send it to your own function that does the upsert.

Can HubSpot enrol a contact in a Plandalf countdown?

Yes, through a workflow action that sends a webhook to a Plandalf catch URL, where Enroll in Promo starts the timer. Check which HubSpot subscription includes that action.

Checked October 26, 2026 against Plandalf's own setup guides and the vendor documentation: HubSpot CRM API: contacts, HubSpot private apps overview, HubSpot: use webhooks with workflows.