Integrating your website directly with HubSpot allows you to automatically sync user data without relying on manual exports or third-party form tools.<\/p>\n\n\n\n
This is especially useful for membership sites, SaaS platforms, and any application where users register and update their details directly on your system.<\/p>\n\n\n\n
In this guide, we\u2019ll build a simple PHP integration using the official HubSpot SDK that will allow you to create, update, and manage contacts automatically.<\/p>\n\n\n\n
Install the official HubSpot PHP SDK using Composer:<\/p>\n\n\n\n
composer require hubspot\/api-client<\/code><\/pre><\/div>\n\n\n\nThen include Composer\u2019s autoloader in your project:<\/p>\n\n\n\n
require_once 'vendor\/autoload.php';<\/code><\/pre><\/div>\n\n\n\nStep 2: Create a HubSpot Private App<\/h2>\n\n\n\n
To connect your application to HubSpot, you need an access token from a Private App.<\/p>\n\n\n\n
\n- Go to HubSpot settings<\/li>\n\n\n\n
- Navigate to Integrations \u2192 Private Apps<\/li>\n\n\n\n
- Create a new app<\/li>\n\n\n\n
- Enable CRM Contacts read\/write access<\/li>\n\n\n\n
- Copy your access token<\/li>\n<\/ul>\n\n\n\n
Store your token securely using an environment variable:<\/p>\n\n\n\n
$accessToken = getenv('HUBSPOT_ACCESS_TOKEN');<\/code><\/pre><\/div>\n\n\n\nStep 3: Create the HubSpot Class<\/h2>\n\n\n\n
Create a simple service class to initialise the HubSpot client.<\/p>\n\n\n\n
<?php\n\nuse HubSpot\\Factory;\nuse HubSpot\\Client\\Crm\\Contacts\\Model\\Filter;\nuse HubSpot\\Client\\Crm\\Contacts\\Model\\FilterGroup;\nuse HubSpot\\Client\\Crm\\Contacts\\Model\\PublicObjectSearchRequest;\nuse HubSpot\\Client\\Crm\\Contacts\\Model\\SimplePublicObjectInput;\n\nclass Hubspot\n{\n private $client;\n\n public function __construct()\n {\n $this->client = Factory::createWithAccessToken(\n getenv('HUBSPOT_ACCESS_TOKEN')\n );\n }\n}<\/code><\/pre><\/div>\n\n\n\nStep 4: Map User Data to HubSpot Properties<\/h2>\n\n\n\n
Before sending data to HubSpot, map your user object to HubSpot’s contact properties. Also include any custom properties you may have created within Hubspot. <\/p>\n\n\n\n
public function assignUserProperties($user)\n{\n if (!$user->userid) {\n return false;\n }\n\n return [\n 'user_id' => $user->userid,\n 'email' => $user->email,\n 'phone' => $user->tel_code . $user->tel,\n 'firstname' => $user->fname,\n 'lastname' => $user->lname,\n 'subscribed' => $user->subscribed,\n 'subscription_start_date' => $user->sub_start,\n 'subscription_expiry_date' => $user->sub_expire,\n 'last_login' => $user->last_login,\n ];\n}<\/code><\/pre><\/div>\n\n\n\nStep 5: Check for Existing Contacts<\/h2>\n\n\n\n
Check whether the email already exists in HubSpot to avoid duplicates.<\/p>\n\n\n\n
public function searchContacts($property, $value)\n{\n $filter = new Filter([\n 'property_name' => $property,\n 'operator' => 'EQ',\n 'value' => $value\n ]);\n\n $filterGroup = new FilterGroup([\n 'filters' => [$filter]\n ]);\n\n $searchRequest = new PublicObjectSearchRequest([\n 'filter_groups' => [$filterGroup],\n 'limit' => 1\n ]);\n\n $results = $this->client\n ->crm()\n ->contacts()\n ->searchApi()\n ->doSearch($searchRequest);\n\n if (count($results->getResults()) > 0) {\n return $results->getResults()[0]->getId();\n }\n\n return false;\n}<\/code><\/pre><\/div>\n\n\n\nStep 6: Create a Contact<\/h2>\n\n\n\n
Create a new one in HubSpot (automatically check for duplicates).<\/p>\n\n\n\n
public function addContact($user)\n{\n $existingId = $this->searchContacts('email', $user->email);\n\n if ($existingId) {\n \/\/ UPDATE DATABASE; contact already exists in Hubspot, update `hubspot_contactid` in user table with $existingId\n\n return true;\n }\n\n $contact = new SimplePublicObjectInput([\n 'properties' => $this->assignUserProperties($user)\n ]);\n\n try {\n $response = $this->client\n ->crm()\n ->contacts()\n ->basicApi()\n ->create($contact);\n\n $hubspotId = $response->getId();\n\n \/\/ You need to store the $hubspotId in your database here\n\n return true;\n\n } catch (Exception $e) {\n return false;\n }\n}<\/code><\/pre><\/div>\n\n\n\nStep 7: Update a Contact<\/h2>\n\n\n\n
When a user updates their account, we push the changes to HubSpot. If the user doesn’t already have a hubspot_contactid<\/code> add a new contact instead.<\/p>\n\n\n\npublic function updateContact($user)\n{\n if (!$user->hubspot_contactid) {\n return $this->addContact($user);\n }\n\n $contact = new SimplePublicObjectInput([\n 'properties' => $this->assignUserProperties($user)\n ]);\n\n try {\n $this->client\n ->crm()\n ->contacts()\n ->basicApi()\n ->update(\n $user->hubspot_contactid,\n $contact\n );\n\n \/\/ UPDATE DATABASE; I recommend having a `hubspot_last_updated` field to update in the users table, or some sort of log so you can track what's going on\n\n return true;\n\n } catch (Exception $e) {\n return false;\n }\n}<\/code><\/pre><\/div>\n\n\n\nStep 8: Delete a Contact<\/h2>\n\n\n\n
You can also archive contacts in HubSpot if needed i.e. when admin or the user themselves deletes a user account. <\/p>\n\n\n\n
public function deleteContact($contactId)\n{\n if (!$contactId) {\n return false;\n }\n\n try {\n $this->client\n ->crm()\n ->contacts()\n ->basicApi()\n ->archive($contactId);\n\n return true;\n\n } catch (Exception $e) {\n return false;\n }\n}<\/code><\/pre><\/div>\n\n\n\nNote that in the try\/catch blocks you’ll want to deal with and log errors properly. <\/p>\n\n\n\n
<\/p>\n\n\n\n
This code is free to use at your own discretion. It comes without warranty. Please feel free to feedback any edits.<\/p>\n","protected":false},"excerpt":{"rendered":"
Integrating your website directly with HubSpot allows you to automatically sync user data without relying on manual exports or third-party form tools. This is especially useful for membership sites, SaaS platforms, and any application where users register and update their details directly on your system. In this guide, we\u2019ll build a simple PHP integration using […]<\/p>\n","protected":false},"author":12,"featured_media":13135,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[2],"class_list":["post-13119","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-web-and-ux"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.bronco.co.uk\/our-ideas\/wp-json\/wp\/v2\/posts\/13119","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.bronco.co.uk\/our-ideas\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.bronco.co.uk\/our-ideas\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.bronco.co.uk\/our-ideas\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bronco.co.uk\/our-ideas\/wp-json\/wp\/v2\/comments?post=13119"}],"version-history":[{"count":10,"href":"https:\/\/www.bronco.co.uk\/our-ideas\/wp-json\/wp\/v2\/posts\/13119\/revisions"}],"predecessor-version":[{"id":13134,"href":"https:\/\/www.bronco.co.uk\/our-ideas\/wp-json\/wp\/v2\/posts\/13119\/revisions\/13134"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.bronco.co.uk\/our-ideas\/wp-json\/wp\/v2\/media\/13135"}],"wp:attachment":[{"href":"https:\/\/www.bronco.co.uk\/our-ideas\/wp-json\/wp\/v2\/media?parent=13119"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.bronco.co.uk\/our-ideas\/wp-json\/wp\/v2\/categories?post=13119"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}