Welcome to the BrightTALK Element

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.

Element details

Base URL

Authenticating with Cloud Elements

Element Details

Before you get started, review the following table to see basic information about the Element.

Base URL

The Cloud Element Base URL for all API calls is https://api.cloud-elements.com/elements/api-v2.

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.

Authenticating with Cloud Elements

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.

  or

• GET /instances/<INSTANCE_ID>

An Element token and a User secret are required to execute one of our Hub API calls (e.g. /hubs/documents/files or /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.