How to trigger double opt-in confirmation emails when creating contacts via HubSpot API?

I’m working on a project where we’re adding new contacts to HubSpot through their REST API endpoints. Our registration form is custom built with React instead of using HubSpot’s native forms.

The issue I’m facing is that when users fill out our form and get added as contacts, they don’t receive the double opt-in confirmation emails automatically. The contacts are being created successfully in HubSpot, but the email verification step isn’t happening.

I’ve already configured the double opt-in settings in our HubSpot account, but it seems like this feature only works with HubSpot’s own forms. Is there a specific API endpoint or parameter I need to include when creating contacts to trigger these confirmation emails? Or do I need to handle this process differently when using external forms?

yeah, hubspot’s api is kind of limited in this area. i solved it using workflows - create the contact via api and set a custom property like ‘needs_confirmation’ to true. then set up a workflow to send the confirm email when that property updates. once they confirm, update the property again through the api. it’s a workaround but it works.

HubSpot’s double opt-in only works with their native forms - it won’t trigger when you create contacts through the API. I hit this same issue six months ago building a custom integration. The double opt-in settings in your portal don’t apply to API contacts, just form submissions. You’ll have to build your own confirmation workflow. I created contacts with a custom property tracking confirmation status, then used HubSpot workflows to send confirmation emails based on that property. Or you could handle email confirmation entirely in your React app before sending confirmed contacts to HubSpot. It’s extra work but gives you better control over the UX and keeps you compliant with opt-in requirements.