Import Registrant Data from HubSpot to Zuddl
Previous step: Field mapping
- Connecting a Zuddl app
- Using webhook - if available for your HubSpot plan
Prerequisites
Warning: Before you enable the event-level integration, ensure that the “Event invitation” email for attendees has been toggled on from the Communication menu. Without this enablement, registrants will not receive any event invitation.
Connecting to Zuddl App
Allowed fields
- First name
- Last name
- Job Title
- Company
- Country
On the HubSpot dashboard, go to Workflows.
Click Create workflow.
- On the workflow creation screen, click From scratch. You must create a contact-based workflow. Learn how to create a workflow.
- Select the Contact-based and then choose how to start the workflow under the How do you want this workflow to start? For example, select Blank workflow option.
Click Next.
On the workflow edit page, click the Set up triggers button and select the “When filter criteria is met” trigger. This option lets you filter contacts within a particular list.
In the Add a filter, select List membership Hub and select the desired list from the options. For example, “Acme list”.
Add desired filters and click Save to save your filter criteria.
Now, to set up the Zuddl app, on the workflow edit page, click the + button.
A left-side pane shows options under “Choose an action.” Under “Choose an action” on the left-side pane, click Connect app button under Connected apps section.
Search for the Zuddl app using the search bar. It appears after you have installed the HubSpot app on Zuddl. The Zuddl app shows up with the Create Registration action.
- Under Select the fields to be passed in Zuddl to create registrations section, enter the following:
- Event Id in Zuddl: This denotes the Zuddl event in which registration needs to be passed. Copy the event Id from your Zuddl dashboard URL and paste it here.
- Webhook Url from Zuddl: Copy the public URL from the HubSpot installation step and paste it here.
Ticket Id in Zuddl: Enter the ticket Id if you wish to pass registrations to a specific ticket. Only for ticketed events. Learn how to create a ticket.
Note: The allowed standard fields are shown under Properties always included with the action. Country/Region, First name, Job title, Company name, Email, and Last name.
Select the fields in the Properties always included with the action field.
Note: Ensure that these fields are mapped at org-level in Zuddl.
Click the Save button on top.
This saves the configuration for the connected app.
- Now your workflow is ready, click Review and publish.
- Click Turn on. This will enable the workflow and start passing registrations to Zuddl.
Using Webhooks
Event-level settings
To map HubSpot fields with Zuddl,
- Inside the Zuddl dashboard, go to the connected event/webinar then inside event/webinar setup, go to Integrations.
On the HubSpot card, click Customize on the Import section to configure the event-level settings. The Import section shows a Disabled status before turning on the integration.
Any new Contact in HubSpot is synced as a new registrant for your Zuddl event/webinar. Under the Custom fields tab, map any custom Contact fields in your HubSpot instance to suitable Zuddl registration fields in Zuddl.
Prerequisite: A Zuddl registration form with all the required fields needs to be created to map the fields.- Select a custom field in the Zuddl registration fields dropdown.
Choose a suitable HubSpot Contact field from the Contact fields drop down that needs to be passed to Zuddl.
- Click +Add field to add map more fields in the same way.
- Click Save.
After mapping the fields, you must setup a webhook-based workflow from HubSpot to Zuddl
Setting up Webhooks on HubSpot
- Steps 1 - 5 are the same as the previous section “Connecting to Zuddl App”.
On the workflow edit page, click Set up triggers.
- On the Enrollment triggers, under the Trigger tab, select a Filter type. Learn more about enrollment triggers.
- Click Save.
Click the + button on the left workflow preview and select the Send a webhook action.
This adds to the flow chart on the left. Under Create action, do the following:
- In the Method dropdown, select POST.
- In the Webhook URL, enter the URL copied while installing the HubSpot app on Zuddl.
You need to append the eventId/webinarId to the URL. You can find the eventId in the Zuddl event URL, for example, “setup.zuddl.io/event/<youreventId_or_webinarId>/event-integration”.
After you’ve copied the eventId/webinarId, add it to the Webhook URL as shown below:
“https://<your-alphanumeric-webhook-url>.trayapp.io?eventId=<your-alphanumeric-eventId>”.
An example webhook URL with event Id is shown below:
“https://21b88ed1-f905-45b3-962c-5207b9b89b4e.trayapp.io?eventId=29436a45-3ff2-48af-97e5-66d1e5610030”
- Ignore the remaining fields and click Save. This completes the workflow, you need to now click on Review and publish.
- On the Review before you turn on page, under These contacts already meet the trigger criteria. Do you want to enroll them when this workflow turns on? select either of the following options
- Yes enroll existing contacts who meet the trigger criteria as of now - select this option if you wish to sync existing contacts
- No, only enroll contacts who meet the trigger criteria after turning the workflow on - select this option if you wish to sync only new contacts and not the existing ones
Click the Turn on button at the top right corner. This turns on the workflow and could take about 2-3 minutes for the contacts in the list to appear as Attendees in Zuddl.
Note: The organizers would not be shown in the attendee list.