BrightTALK is a webinar and video meeting API provider. BrightTALK uses the web service called Bulkloader to provide connections to other services like Oracle Eloqua, HubSpot, and Salesforce Sales Cloud.
This overview describes basic element details, the Base URL for API calls, and information about authenticating with Cloud Elements.
Before you get started, review the following table to see basic information about the Element.
|API Documentation||BrightTALK API documentation|
|Authentication||To create an instance, you must know the API Key and API Secret.|
The Cloud Element Base URL for all API calls is
HTTP requests to the REST API are protected with HTTP Basic authentication with your Organization and User secret and an Element token. We use many standard HTTP features, like HTTP verbs, understood by most HTTP clients. JSON is returned in all responses from the API, including errors. The APIs have predictable, straightforward URLs and use HTTP response codes to indicate API errors.
To authenticate with Cloud Elements, you need to know your Organization Secret and User Secret. When making some calls, you also need to know the Element Token.
When you create an account with us, we assign you an Organization Secret and a User Secret. An Organization is a customer of Cloud Elements (
/organizations). The User and Organization secrets represent your account with Cloud Elements.
To find your Organization and User Secret, click Secrets in Cloud Elements:
When you create a new connection to an endpoint, you will receive an Element token. After you create an instance, Cloud Elements automatically refreshes the token behind the scenes so that you won't need to connect your application again.
To find your Element token:
Open Cloud Elements, go to My Instances, and then click Token.
An Element token and a User secret are required to execute one of our Hub API calls (e.g.
/hubs/crm/contacts). For more information about Hubs, see the Hub API docs in the navigation area.
Pass tokens and secrets as basic HTTP Header values.
To make a Platform or API call, include the following in the header:
Authorization: User 7OpR4MRo7wnPoVKkKFXHhHBUPRzqutoem/d+WEnR1kY=, Organization ce7f1f9be0d2a8b1f37bcfa6d71eda20
To make a Hub API call, include the following in the header:
User 7OpR4MRq7wnpnVKkKFXhhHbUPRzQutoem/d+WEnR1kY=, Element fJ5HQ135fW4okMt5AWq0hzm2X7kaK5OpQB0Uxjvlz6U=
Get started by creating an instance.