https://github.com/danielstieber/leadtohubspot
A ProcessWire Module, that lets you create and update contacts in your Hubspot CRM.
https://github.com/danielstieber/leadtohubspot
hubspot hubspot-crm processwire
Last synced: 4 months ago
JSON representation
A ProcessWire Module, that lets you create and update contacts in your Hubspot CRM.
- Host: GitHub
- URL: https://github.com/danielstieber/leadtohubspot
- Owner: danielstieber
- Created: 2018-04-06T17:13:02.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-04-13T16:15:14.000Z (about 8 years ago)
- Last Synced: 2025-07-21T18:09:40.292Z (11 months ago)
- Topics: hubspot, hubspot-crm, processwire
- Homepage:
- Size: 13.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
**OUTDATED. [SubmitToHubspot](https://github.com/danielstieber/SubmitToHubspot/) is what you are looking for**
# LeadToHubspot
Module for ProcessWire that saves contacts in the Hubspot CRM (e.g. from a leadform).
## How To Install
1. Download the [zip file](https://github.com/danielstieber/LeadToHubspot/archive/master.zip) at Github or clone directly the repo into your `site/modules`
2. If you dowloaded the `zip file`, extract it in your `sites/modules` directory
3. Goto the modules admin page, click on refresh and install it.
## API
You must create an API key in your Hubspot account. To get your API-Key, log into hubspot.com, click on your avatar in the top right corner and go to "Integrations / Hubspot API-Key". Add the API key in the module settings page.
## Usage
1. Read the restrictions
2. Call the module: `$hubspot = $modules->get("LeadToHubspot");`
3. Call function saveLead and pass your data array: `$hubspot->saveLead(['email' => 'john.doe@example.com', 'firstname' => 'John', 'lastname' => 'Doe'])`
## Additional Methods
### Get information of a Hubspot contacts property
Example: `$hubspot->getProperty('firstname');`
Returns a Hubspot contacts property in JSON. Returns false if the property does not exist.
### Create a new Hubspot contacts property (restricted)
Example: `$hubspot->createProperty('favourite_color', 'Favourite Color');`
Creates a new Hubspot contacts property. Currently only text, textarea, date, number and booleancheckbox are supported.
## Important Notes
### Functionality
The module creates or updates a lead based on the transmitted data array. The field 'email' works as identifier.
### Restrictions in this version
* The data **must contain a key 'email'** (it is used as identifier).
* Every key in the data array, **must be a field in your CRM properties**. You can find and overview of the default or create additional properties at hubspot.com -> Settings / Properties), or use the getProperty / createProperty methods.
* For createProperty currently only text, textarea, date, number and booleancheckbox field types are supported.
**I strongly recommend a server-sided form validation like [Valitron](https://github.com/vlucas/valitron)**
## Example Code
Example data array:
```PHP
$data = [
'email' => 'john.doe@example.com',
'firstname' => 'John',
'lastname' => 'Doe',
'company' => 'ExampleCompany Ltd.',
'phone' => '123456789'
];
```
Example usage after form post:
```PHP
// ... validation of form data
$data = [
'email' => $input->post->email,
'firstname' => $input->post->firstname,
'lastname' => $input->post->lastname,
'message' => $input->post->message,
];
if($hubspot->saveLead($data))
echo "Thank you for your Message.";
else
echo "Oops, an error accured while transmitting your data. We are sorry for the inconvinience. For your own security, your data has not been saved. Why not contact us directly at office@companyemail.com and we have talk about your request, while our IT-team is fixing the problem?";
```
## Troubleshooting (check your ProcessWire warning logs)
### Hubspot Lead not saved: 400 Bad Request: ...
The data you pass is not valid for a creating/update a contact in hubspot. This mostly happens when you use non-existing properties.
1. Check for typos in your data array
2. Check if properties exist in Hubspot
3. Unquote the line 'die(var_dump(json_encode($param)));' in site/modules/LeadToHubspot.module and check if the output is valid JSON format
### Working with Date & DateTime Data
Hubspot is very picky, when it comes to Date and DateTime fields. (Learn more here: [How should timestamps be formatted for HubSpot's APIs?](https://developers.hubspot.com/docs/faq/how-should-timestamps-be-formatted-for-hubspots-apis))
Example:
```PHP
$lead = [
'email' => $input->post->email,
'newsletter_registration_date' => strtotime('today midnight') * 1000, // newsletter_registration_date is a Hubspot Datepicker property
]
```