How to: Configure a Generic Inbound Registration Integration

Araceli Romero

December 26, 2024 20:28

Follow

The Brandlive Platform’s inbound registration integration allows you to host registration for your webinar or event wherever it’s most convenient for your tracking needs. Host registration with a third-party form of your choice that will automatically sync to your Brandlive Platform webinar log-in system, enabling seamless access for your attendees without needing registration to originate from Brandlive.

Important Note

• All fields have a 50-character limit. if the limit is exceeded this will result in an error
• We are offering an endpoint to map the registration fields to, from a third party app. In response to you sending the registration data to Brandlive, Brandlive returns a confirmation URL. From there, the customization options are up to your discretion depending on your intended use.
• At this point in time, the Brandlive Platform does not send a confirmation email using this registration flow. Improvements to this are likely to come in the future.

Configuration Steps

1. From the Projects dashboard, select “Settings” from the top navigation.
2. In Settings, navigate to the “API Keys” tab on the left hand panel. To generate your token, click “Create New API Key.” A spreadsheet will download containing your secret and API key. If lost, the secret cannot be recovered, so store the credentials in a safe place.
3. Then return to the Projects dashboard and select the Project you are trying to configure your integration for. Navigate to the Integrations tab of the Project Details page.
4. After selecting “edit” on the CRM tile of your choice, copy both API endpoint and payload information from the popout.
   
5. Please note that if you are using a custom third-party platform to send registrations rather than one of the listed CRMs, your endpoint is simply: http://api-hv.brandlive.com/inbound-registration. This webhook URL and associated payload can be copied from any of the CRM workflows with the CRM path removed and will function with the same API credentials.
6. To avoid any conflicts with other integrations you have configured, toggle “Disable Native Registration” ON and input your third-party hosted form address into the field that appears. Click Save and then enter the Sitebuilder to publish your project.
7. Add the API key and secret to your system of choice’s authorization header:
   

   To use the key and secret, base64 encode them as a 
   
   Basic `Authorization` header on all your requests to the api.

8. 7. In response, you will get a confirmation URL (see format below) which you can use in your other workflows. Note: if a user clicks this returned URL, they will automatically be admitted into your Brandlive site.
   
   

   {
     "link": "https://event-link.com"
   }