BlueJeans is being sunset. Please refer to more details

Events

When provisioning an app, a client key and secret are generated. These are further used to generate access tokens using Authentication APIs. This access token generated via Authentication APIs is further used with each API call made by the client application. There are two methods of obtaining an access token - User Application Grant and Enterprise Application Grant.

1. User Application Grant: It is used to authenticate user-level resources.

2. Enterprise Application Grant: It is used to authenticate enterprise-level resources.

3. Registration Application Grant: It is only used to authenticate the Register a User for an Event APIs.

How to generate Client Key and Client Secret

Enterprise Admin should create the app key and secret on the BlueJeans Events Admin page. Admin should provide an appropriate app name and description as input to get the key and secret. This is further used to generate an access token. Note that this is a one-time activity.

Follow the below steps:

Login to your BlueJeans Account and navigate to the Admin console.
Note

BlueJeans needs to enable enterprise-level APIs for you. Check if you see a tab called "Enterprise Apps" under Events section. If yes, it means that the capability is enabled. If not, please contact support@bluejeans.com and request for it to be enabled.
To access enterprise-level APIs in BlueJeans, you need to ensure that the Admin capability is enabled. You can check if the "Enterprise Apps" tab is available under the Events section. If you can see this tab, it indicates that the enterprise-level API capability is already enabled for your account. However, if you do not see the "Enterprise Apps" tab, please reach out to support@bluejeans.com and request them to enable it for you.
Select Enterprise Apps and click Add New App. Add name and some description for the app and click Save Changes.
Click on the extreme right corner of your app to get the app secret. Copy your key and secret for further use.

Get User-App Access Token

Hostname: https://a2m.bluejeans.com/

This grant type is used by an application, which needs to access user level API resources. Client ID and secret along with a valid BlueJeans account are passed as input.

Request Body:

curl --location --request POST '<hostname>/api/security/v1/oauth/accesstoken' \
--header 'Content-type: application/json' \
--header 'Accept: application/json' \
--data-raw ' {
     "grant_type": "user_app",
     "properties": {
       "client_id": "<client_id>",
       "client_secret": "<client_secret>",
       "user_email": "firstname.lastname@bluejeans.com"
      }
    }'

The HTTP method used here is POST. A method that is used to send data for adding new information to an API server. A brief description of each field in the request is given below-

Field	Format	Description
grant_type	string	This specifies the kind of grant being requested. It should mandatorily have the value as “user_app”.
client_id	string	This is the app key created by the enterprise admin.
client_secret	string	This is the app secret created by the enterprise admin.

Sample Response:

{
    "access_token": "<access token>",
    "expires_in": 86400,
    "userId": 123,
    "enterpriseId": *****
}

A brief description of each field in the response is given below-

Field	Format	Description
access_token	string	This is the user app token. It is used as an Authorization Bearer token for APIs.
userId	integer	This represents a user's identity in BlueJeans Primetime APIs. This is used in user centric APIs.
enterpriseId	integer	This represents a user's enterprise in BlueJeans Primetime APIs. This is used in enterprise-centric APIs.

Get Enterprise-App Access Token

Hostname: https://a2m.bluejeans.com/

This grant type is used by an application, which needs to access enterprise-level API resources. Client ID and secret along with a valid BlueJeans account are passed as input.

Request Body:

curl --location --request POST '<hostname>/api/security/v1/oauth/accesstoken' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
     "grant_type": "enterprise_app",
     "properties": {
       "client_id": "<client_id>",
       "client_secret": "<client_secret>"
      }
}'

The HTTP method used here is POST. A method that is used to send data for adding new information to an API server. A brief description of each field in the request is given below-

Field	Format	Description
grant_type	string	This specifies the kind of grant being requested. It should mandatorily have the value as “enterprise_app”.
client_id	string	This is the app key created by the enterprise admin.
client_secret	string	This is the app secret created by the enterprise admin.

Sample Response:

{
    "access_token": "<access_token>",
    "expires_in": 86400,
    "enterpriseId": 31
}

A brief description of each field in the response is given below-

Field	Format	Description
access_token	string	This is the enterprise app token. It is used as an Authorization Bearer token for APIs.
enterpriseId	integer	This represents a user's enterprise in BlueJeans Primetime APIs. This is used in enterprise-centric APIs.

Get Registration Access Token

Hostname: https://a2m.bluejeans.com/

This API is used to get an access token that is used to call the registration APIs. Registration APIs are relevant where user registration is required for joining an event. It uses client key, client secret, Event ID and registration API key as input parameters. Follow the below steps for getting a registration access token-

Step 1. Get App key and secret

Refer to "Client Key and Secret Generation" section above to know the steps.

Step 2. Get Registration Event ID and Registration API Key

Schedule an Event by enabling Require Registration checkbox.

After the event is scheduled, select Manage Registrations.

Click Settings -> Integrations. Select BlueJeans API. You will see Event ID and Registration API Key right below. Copy these and click Save Changes.

Note

When you are scheduling an event via REST API, set the below fields as follows:

{
    .
    .
    "enableRegistration": true,
    "registration": {
        "integrationModified": true,
        "integration": [
            {
                "provider": "apiIntegration"
            }
        ]
    }
    .
    .
}

Event ID and Registration API Key can be obtained from Get Events API response.

{
    .
    .
    "id":"...", //event id
    .
    .
  "registration" : {
    .
    .
    "apiKey" : "...", //registration api key
    .
  },
  .
  .
}

Step 3. Get Event Registration Access Token

This API takes the client key and client secret from first step, Event ID and Registration API key from second step as input parameters and gives access token as a part of response.

Request Body:

curl --location --request POST 'https://a2m.bluejeans.com/api/security/v1/oauth/accesstoken' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
        "grant_type":"registration_app",
        "properties": {
            "client_id":"<client_id>",
            "client_secret":"<client_secret>",
            "api_key":"<registration api key>"
        }
    }'

Field	Format	Description
grant_type	string	This specifies the kind of grant being requested. It should mandatorily have the value as “enterprise_app”.
client_id	string	This is the app key. Refer to first step for the same.
client_secret	string	This is the app secret. Refer to first step for the same.
api_key	string	This is the registration api key. Refer to second step for obtaining this key.

Sample Response

{
        "access_token": "<access_token>",
        "expires_in": 86400
}

This access_token can be used to call the Registration APIs. Refer to Register a User for an Event for details.