Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry AtHoc
  3. BlackBerry AtHoc SDKs and APIs 7.7
  4. API Quick Start
  5. Set up your environment
  6. Provision an application that can call the web API

Provision an application that can call the web API

To provision a new API integration with the BlackBerry AtHoc management system, you must have organization administrator, enterprise administrator, or system administrator permissions. You must have system administrator permissions to enable a provisioned application.
The Client ID and Client Secret can only be used in the organization in which they are created. If the Client ID and Client Secret are created in the System Setup (3) organization, they can be used in any organization. If the Client ID and Client Secret are created in an Enterprise organization, they can be used in any of that Enterprise's sub organizations. If the Client ID provided does not follow these inheritance rules, a 400 (Bad request) error code is returned.
To provision a new API integration, complete the following steps:
  1. Log in to the BlackBerry AtHoc management system as an organization administrator, enterprise administrator, or system administrator.
  2. In the navigation bar, click the Settings icon (
    Settings
    ) icon.
  3. In the System Setup section, click 
    API Applications
    . The API Applications window opens.
  4. Click 
    New
    . The New API Application window opens.
  5. Enter a name for the API integration.
  6. (System administrators only) Next to Status, select the 
    Enabled
     check box.
  7. In the Authentication section, select a Grant Type. Password is the default. If you select Implicit, enter a redirect URI in the text box that appears.
  8. Click 
    Save
    .  A Success message appears that includes the Client ID and Client Secret.
  9. Take note of the displayed Client Secret. It is displayed only once and will need to be regenerated if lost.
After you provision your application in the BlackBerry AtHoc management system, contact BlackBerry AtHoc Customer Support to have the application reviewed and enabled.