Build multi-region integrations

Bluebeam’s API platform supports multi-region integrations through region-specific base URLs, enabling developers and partners to build integrations for customers in hundreds of countries across the globe where Bluebeam is available. Integration data can be stored in five server regions—United States, Australia, Germany, United Kingdom, and Sweden.

When installing an integration, users select a server region based on their data residency requirements and Studio server region. The integration can then be used globally, as Bluebeam does not enforce geofencing. By leveraging the appropriate region-specific URL alongside your API requirements, you can deliver a consistent integration experience across multiple geographies while maintaining compliance with local infrastructure and data residency standards.

Develop integrations outside of the supported regions (US, AU, DE, UK, and SE)

Integration development through the Bluebeam Developer Portal is available to active customers, channel partners, and software partners in the US, AU, DE, UK, and SE regions. If your organization is outside these regions, select a supported region that best fits your customers' local data residency requirements.

For example, if you are in India, you can build an integration that uses the Australia API endpoints or the US API endpoints, depending on your customers' local data residency requirements.

Customers can choose the server region based on their own project and data residency requirements.
The Studio server region must match the same integration server region.

Select the base URL for your Bluebeam API region

Bluebeam API endpoints remain the same across all regions; only the base URLs differ depending on the selected region.

There are region-specific base URLs that apply to all endpoints:

- 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.se

For example, https://api.bluebeam.com/publicapi/v1/sessions in the US would be https://api.bluebeamstudio.com.au/publicapi/v1/sessions in AU.

Set up multi-region integrations

Each Studio server region operates independently; Sessions and Projects do not transfer across server regions.
The Studio server region must match the same integration server region.
Always validate regional data residency and latency requirements for your customers when selecting server regions.

  1. Navigate to the Bluebeam Developer Portal and sign in with your existing Developer Portal credentials.

    Your account provides access to all Bluebeam API server regions, regardless of your initial server region association.

  2. Request Bluebeam API access by region.

    1. In the Developer Portal, go to My Apps and select Request Access.

    2. Use the dropdown menu to select your desired Bluebeam API region instance.

    3. Complete all required fields:

      • OAuth 2.0 Grant Type: Select only Authorization code and Refresh token.

      • Redirect uri: Use https://oauth.pstmn.io/v1/callback.

    4. Select Request. Your registered app will be granted access to the region-specific Bluebeam API endpoints.

  3. When integrating, use the appropriate region-specific base URL for each Bluebeam API endpoint.

    For example, the base URL in the US will be https://api.bluebeam.com/publicapi/v1/sessions; the base URL in AU will be https://api.bluebeamstudio.com.au/publicapi/v1/sessions).

  4. For constructing a Bluebeam Studio Session invite URL, use the URL specific to the Bluebeam Studio server:

  5. Use your existing Bluebeam subscription to test integrations in Studio server regions outside your Bluebeam account's original server region.

    To do this, create a Bluebeam ID for the selected Studio server region.

  6. On the sign-up page for the Studio server region, use your existing email and create a new password unique to that server region.

    The system will recognize your Bluebeam subscription and grant access to Bluebeam Studio in the selected server region.

  7. Log in to the Studio server region.

    • On Revu desktop, log in to Revu with your Bluebeam account's original server region—this will ensure that the system recognizes your subscription entitlement.

      After logging in, on the side panel, select the Studio server region of your choice and log in separately.

    • On Bluebeam for web or mobile, go the app.bluebeam.com, and log in with the Bluebeam username and password for the specific Studio server region.

Contact Development support

For questions about the integrations functionality, specific API endpoints, and other Bluebeam related questions, email us at integrations@bluebeam.com.

For detailed information on API endpoints and the latest updates to the Integrations platform, visit the API Docs section in the Developer Portal.

Resources

Revu 21

Bluebeam Integrations

Bluebeam Integrations

Bluebeam’s API platform supports multi-region integrations through region-specific base URLs, enabling developers and partners to build integrations for customers in hundreds of countries across the globe where Bluebeam is available.