Get started in the Bluebeam Developer Portal

When you log in with your BBID credentials via Okta, the portal instantly verifies your eligibility. There is no manual onboarding request or email to the Partnerships team required unless you are a Software developer and/or partner.

Subscription requirements

At login, the portal checks that your account meets all three criteria:

• Valid BBID account

• Active Core, Complete, or Max subscription

  • Basics plan not eligible: Basics subscribers cannot access the Developer Portal because they cannot create Projects and Sessions, which are critical operations for most integrations. Upgrade to Core, Complete, or Max to gain access.

  • Software developers and partners: If you need a special NFR license through Bluebeam Partnerships, you will need to request access to the Bluebeam Developer Portal.

• Eligible region: US, AU, DE, UK, and SE

All new apps are created in the Sandbox environment by default. Sandbox gives you a dedicated space to build and test your integration safely before it reaches end users.

• Sandbox credentials will remain consistent as your app is moved to Production.

• When promoting to Production, rate limits will adjust to support real-world usage constraints.

• Apps remain in Sandbox until you explicitly request Production approval (see Step 6).

The app creation flow has been redesigned. The Create Application form shows only the fields relevant to Bluebeam integrations.

Platform & regions

1. Go to My Apps and select Create Application.

2. Select the API instance that matches your region when creating your application:
   
   

   • US: https://api.bluebeam.com

   • DE: https://api.bluebeamstudio.de

   • AU: https://api.bluebeamstudio.com.au

   • UK: https://api.bluebeamstudio.co.uk

   • SE: https://api.bluebeamstudio.s

   
   
   

Registration Form fields

3. Fill out the Registration Form fields:

   • Application name: Enter up to 90 characters.

   • Description: Enter up to 300 characters.

   • Region: Select the Bluebeam API instance for your region.

   • Redirect URL(s): Enter comma-separated values or press Enter–the portal organizes them in a paginated list.

   • Testing with Postman? For Redirect URI, use https://oauth.pstmn.io/v1/callback. Your production app will use a different URI.

Authentication notes

4. Bluebeam API supports only the following selections for Grant Type:

   • Authorization Code: All API calls use OAuth 2.0; users grant your app permission to act on their behalf

   • Refresh Token

5. Redirect URI: Use https://oauth.pstmn.io/v1/callback
   
   This URI is specific to making calls in Postman. Alternate API tools or your App will require a different URI.

6. Select Create Application to submit the form.
   
   Upon submitting the form, you'll receive a MuleSoft branded email with the subject: "Application registration approved“. Please ignore the ignore the email. It's an unwanted side-effect of using our out-of-the-box solution.

7. Get credentials. Now you should see your newly created App in the list (if you don't see it, refresh your browser). Click anywhere on the app line, and it will open the details page where you can view your Client ID and Client Secret.
   
   
   
   

8. If using Postman for testing, get an access token via Postman.

   1. Access Postman via their desktop app or browser and create a free account.

   2. Here's a script that you can import into Postman. This script is a collection of all available Bluebeam API calls. In Postman, go to File > Import, and drop the script in.

   3. To get an access_token in Postman, select the Bluebeam API (Script x.x.x) collection.

   4. Select the Authorization tab to configure a new token in Postman.
      
      

      For more information regarding authentication, see the Authentication Guide. The Authentication Guide references request parameters; these are known as variables in Postman.
      You can either set up an environment in Postman to create variables for your authorization, or you can manually fill out the required values.

      Required settings and values in Postman:

      • Auth Type: Must be OAuth 2.0

      • Grant Type: Authorization Code

      • Token Name: code

      • Grant type: Authorization Code

      • Authorize using browser must be enabled.

      • Auth URL: https://api.bluebeam.com/oauth2/authorize

      • Access Token URL: https://api.bluebeam.com/oauth2/token

      • Client ID: Client ID received during the App registration process

      • Client Secret: Client Secret received during the App registration process

      • Scope: Scopes for Studio Endpoints; minimum required is offline_access

      • State: State

      • Client Authentication: Send client credentials in body

   5. Scroll to the bottom and select Get New Access Token.
   6. Sign in with your BBID and select Allow Access when prompted. You'll be presented with a token that you can use in Postman, our API docs, or your own code.

The My Apps table has been updated with additional columns so you can see key app details at a glance.

• Name: Your created app name

• Client ID: The unique identifier used in all API requests

• Environment: The current status (Sandbox, Pending, or Production)

• Created Date: The date the app was created

• Region: The API region your app in created in

• Actions: Select to edit, delete, view credentials, or request Production Approval

At the bottom of the table, view the previous and next pages if managing multiple apps.

Search Endpoints

A new keyword search bar lets you search across all endpoints and parameters without scrolling through the full reference. Type a keyword (e.g., sessions, markups) to jump to the relevant endpoint.

Test Request

Each API endpoint now includes a Test Request button. Select it to open an in-browser panel where you can:

• Fill in query parameters and request bodies

• Execute live API calls directly from the docs

• View the full response inline

• Switch between coding languages (Python, cURL, and more)

Now available: Markups API endpoints are out of Beta and available to all developers. There is no additional access required.

Once your app is built and tested in Sandbox, select Request Production Approval on your app's detail page in My Apps. This opens a pre-addressed email to integrations@bluebeam.com in your default email client.

You must include the following information in the email:

App status after submission

• App status changes to Pending once the approval request is submitted.

• After final approval, your app is promoted to Production.

• You will receive an email that your Integration App is approved, and the status will change to Production in the Portal.