Hubspot Integration

Last updated January 30, 2019

Customers of WorkCast Producer+ and Enterprise licenses have the option to integrate with Hubspot.

hubspot-logo.png

Quick Links

  1. Hubspot Registration Forms

  2. Landing Page

  3. Workflow




Hubspot Registration Forms

 

Standard HubSpot form functionality can be used to create Registration Forms that feed both the HubSpot Platform and the WorkCast Platform.

HubSpot Registration forms can be used to push registration data into the WorkCast Platform. This is done by means of a Webhook through a HTML POST to the WorkCast HubSpot Data Usher interface. This interface is specific to HubSpot. Its purpose is to transform the standard JSON formatted Contact data in to a form that the WorkCast Data Usher can then process.

 

Step 1 - Creating a Form to add to your landing page 

This is registration form that clients will fill out on your HubSpot landing page and submit in order to register for WorkCast Event Sessions.

IMPORTANT: You MUST follow the steps exactly and ensure the form has ALL the required elements WorkCast needs. You can modify an already created form within your HubSpot account if you wish to use that.

 

a) First, create a new Hubspot Form from the Contacts Menu.


 hub1-insite

 

After giving it a suitable name, a basic form will be created containing the minimum required fields and a Submit button. Any required or additional fields can be added or amended using this screen.

Screen Shot 2019-01-30 at 09.54.35

 

Step 2 - Create three additional hidden form fields as below:

The WorkCast Hubspot Data Usher Interface requires the creation of the following 3 fields on the form (Redirect Success, Redirect Failure and Data type):-

 

Label

Internal Name

Default Value

Redirect Success 

wrk_redirectsuccess

http://www.workcast.com/registerthanks.aspx

Redirect Failure

wrk_redirectfailure

http://www.workcast.com/registerthanks.aspx

Data type

wrk_datatype

dcdcfr

 

To add the above hidden form fields please see instructions below

Click on 'Create New' which launches a popup.

 Screen Shot 2019-01-30 at 10.10.40

Within the popup for each of the three hidden fields ensure you add the exact required 'Label' name and 'Internal Name' from the table above.

hub-graphic2

 

Add the 'Default value' using the exact URL in the table above. You will need to repeat this for all three hidden fields. Ensure you tick 'Make this field hidden'.

hub-insite4

 

 

Step 3 - Ensure your form includes the following three standard fields

 

firstname

lastname

email

 

  

Landing Page

 

Step 1 - Ensure you add the correct form to your landing page

This is the landing page where the registration form we have created will be added too and used to promote the event. 

 

Please choose a template that best suits your needs or create your own template using the HubSpot Design Manager. Ensure that the Template used either contains a Form Module or that you add one. Within the landing page select and add the Form created/used in the previous section.

hub-insite5

 

Workflow

 

The Workflow is setup to link the actions of filling out a registration form with the firing of a Webhook. This Webhook pushes the registration to the correct event within the WorkCast platform.

 

Step 1 - Create a new Workflow from the Contacts Menu.

This should be created as a standard 'Contact-based' workflow and you can name this accordingly. 

hub-insite6

hub-insite7

 

Next select 'Set enrollment triggers' and choose 'Form submission. Then ensure you select the form added to your landing page from the dropdown. Then select that the landing page that the form has been added too. Save your changes.

hub-insite9

Now click 'Add an action'  and select 'Trigger a webhook'

hub-insite10

Details to add are listed below:

POST

https://i1.workcast.com/HSRelay.aspx?meid=1234&pak=1234567890123456

Use Authentication = No

IMPORTANT: The ‘meid’ (Managed Event Id) and ‘pak’ (Public Access Code) values shown in the example URL below can be found in the 'Event Experience' section of your event in the WorkCast Platform by clicking the 'i' icon. You need to ensure these values relate to your created WorkCast event. These numbers are unique and will change per event. 

 

 hub-insite11

 

Ensure that the Workflow is saved and that it is made Active.


Once published, anyone that fills out the HubSpot Registration Form will have their registration data pushed to the WorkCast platform and registered for the relevant event. You should test after submitting the registration form to ensure your registration has been passed to the workCast Platform. You can do this by navigation to your event in the WorkCast platform and clicking 'Report Setup'. Here you should see the 'registrations' number increase after submitting your HubSpot Registration form.

 

hub-insite12

 

 

 

 

Was this article useful?

Please provide us with any feedback to help us improve this page