Bluebeam Integrations Hub

Welcome to the Bluebeam Integrations Hub. Use these resources to learn more about what Bluebeam integrations are, how to access integrations, and how to develop private or public integrations between Bluebeam and third-party software.

Bluebeam Integrations FAQs

Read answers to common questions from Bluebeam users and partner developers about accessing and building integrations. Whether you're enabling existing integrations or developing new ones, these questions guide you through key topics such as account setup, authentication, API usage, and managing your integrations within the Developer Portal.

Integrations users

Since third-party integrations are developed by integration partners or developers, some may have specific requirements such as compatible application versions or additional costs. If you have questions about installing or upgrading to the latest version of an integration, please reach out directly to the integration partner or developer for assistance.

Bluebeam customers who use integrations should work directly with the integrations partner to install or upgrade to the latest version of their integration as needed. You do not need to update anything within Bluebeam to use the integrations besides having an active Bluebeam plan.

We provide links to our integrations partners' websites in the Bluebeam Integrations Directory.

Yes! A big part of moving to the new platform is to enable our customers to use SSO/SCIM when using integrations. This will help some users complete their transition to a Bluebeam plan.

Third-party integrations can be used without an Org Admin Pro subscription.

To create Studio Sessions and Projects through an integration, you must have a Bluebeam Core, Complete, or Max plan.

To attend and collaborate in Studio Sessions and Projects through an integration, you must have at least a Bluebeam Basics plan.

If you are a Revu 20 user, you can attend and collaborate in Studio Sessions and Projects through an integration; you cannot create them via the Bluebeam Studio API.

To create Studio Sessions and Projects through an integration, you must upgrade to a Bluebeam Core, Complete, or Max plan.

 

Integrations developers

The Bluebeam Developer Portal, for integrations development, is only available to active customers, channel partners, and software partners in the US, AU, DE, UK, and SE regions. If you are based outside these regions, please select one of the regions above based on your local data residency requirements and potential data latency considerations.

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

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

A 404 bad request error may be caused by a token issue. This can happen if another user account without Developer Portal access was automatically selected on the login screen. The incorrect token then prevents you from logging in successfully. To resolve this, ensure you are logging in with the correct account that has Developer Portal access.

We also suggest trying the following troubleshooting steps to resolve the 404 bad request error:

- Try accessing the Developer Portal in an incognito window or a different browser to log in with the credentials for the Developer Portal.

- Clear your browser cache and try logging in with the credentials for the Developer Portal.

If the steps above do not resolve the issue, the problem may be related to single sign-on (SSO) authentication. If your domain uses SSO with an authenticator such as Okta Workforce, it can cause a configuration conflict that results in a 404 bad request error. To fix this, make sure to add the Developer Portal to your licensing group. This will resolve the issue and allow proper access.

1. You must include offline_access as a scope when generating your access token.

2. For the refresh token requests, you only need the refresh_token and grant_type fields in the body. It will fail if you add anything more.

3. Format the Authorization header as follows:
Authorization Basic {base64 encoded string of client_id:client_secret}

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

Bluebeam Integrations Release Notes

 

Important changes to Bluebeam Developer Portal

  • Rebuilt the Bluebeam Developer Portal to give developers a faster, clearer, and more self-service experience

  • Improved the user interface for displaying API Documentation, including a new search option to find keyword matches

  • Introduced a brand new “Test Request” feature allowing developers to test endpoints in-browser in different coding languages

  • Simplified options when creating a new application

  • Added additional application details and update options to the My Apps table

  • Streamlined the onboarding process for users that have an active BBID and a Core, Complete, or Max plan

  • Introduced new workflows for creating applications in Sandbox environment and submitting to our team for publishing into Production

  • Markups endpoints are out of beta and available to all developer users

Important changes to Bluebeam Integrations rate limiting

As part of our commitment to building a reliable integrations platform, we're implementing integration rate limits starting July 1, 2026. These rate limits help ensure every partner receives consistent, reliable API performance as our ecosystem grows.

What does this mean for you?

After July 1, 2026, user requests that exceed the limit will receive a "Too Many Requests" HTTP 429 error and will not be processed.

What’s changing?

Session Endpoints

  • GET /publicapi/v1/sessions/*
    - 150 requests/minute across all Session GET endpoints combined

  • POST/PUT/DELETE /publicapi/v1/sessions/*
    - 50 requests/minute across all other Session endpoints

Project Endpoints

  • GET /publicapi/v1/projects/*
    - 150 requests/minute

  • POST/PUT/DELETE /publicapi/v1/projects/*
    - 50 requests/minute

Jobs Endpoints

  • GET & PUT /publicapi/v1/jobs/*
    - 100 requests/minute

What can you do?

  • Measure your rate limits using the rate limit headers and adjust integrations accordingly.

  • Replace polling patterns with Webhooks wherever possible to reduce request volume.

Have questions? Contact us.

Update to Bluebeam Studio Projects RevisionID field

On March 2, 2026, we will update the RevisionID field in Studio Projects API responses. This change is important to support overall performance and long-term growth of Bluebeam Studio.

The Bluebeam Studio API is changing the underlying value of the RevisionID field to a different internal identifier for the following endpoints:

Method

Endpoint

GET

/v1/projects/{projectId}/files

GET

/v1/projects/{projectId}/files/by-path?path={path}

GET

/v1/projects/{projectId}/files/{fileId}

GET

/v1/projects/{projectId}/folders/{id}/items

GET

/v1/projects/{projectId}/files/{fileId}/revisions

GET

/v1/projects/{projectId}/files/{fileId}/revisions/{id}

POST

/v1/projects/{projectId}/files/{fileId}/revisions/{id}/restore

If you store or cache RevisionID internally:

  • You should refresh all cached revision data after March 2, 2026, by calling the new revisions list endpoint to retrieve current values.

  • If you don’t refresh the cached revision data, your integration may run into errors after March 2, 2026.

GET /v1/projects/{projectId}/files

Before

After

[{
"$id": "12",
"Id": 354537051,
"Name": "SampleDocument.pdf",
"Path": "/DemoFolder/SampleDocument.pdf",
"ParentFolderId": 354537038,
"Created": "2025-04-23T23:57:20.812851",
"Permission": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": true,
"InSession": false,
"LockOwnerEmail": "bbintegrationsdemo1@bluebeam.com",
"LockOwnerName": "BBIntegrations Demo1",
"RevisionID": 705422365
}..]

[{
"$id": "12",
"Id": 354537051,
"Name": "SampleDocument.pdf",
"Path": "/DemoFolder/SampleDocument.pdf",
"ParentFolderId": 354537038,
"Created": "2025-04-23T23:57:20.812851",
"Permission": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": true,
"InSession": false,
"LockOwnerEmail": "bbintegrationsdemo1@bluebeam.com",
"LockOwnerName": "BBIntegrations Demo1", "RevisionID": 2
}..]

 

GET /v1/projects/{projectId}/files/by-path?path={path}

Before

After

{
"$id": "1",
"DownloadUrl":
"https://s3.amazonaws.com/bluebeam.studio.documents
/projects/ac5....0d7d5?AWSAccessKeyId=AIA3E5....
WX&Expires=1770257465&x-amz-security-token=xxxx",
"Id": 380657794,
"Name": "grid.pdf",
"Path": "/level1/grid.pdf",
"ParentFolderId": 380657776,
"Created": "2025-12-16T23:42:11.39976",
"Permission": "ReadWriteDelete",
"CRC": "90B707AA",
"Size": 3256,
"IsLocked": true,
"InSession": false,
"LockOwnerEmail": "DocusignIntegration@bluebeam.com",
"LockOwnerName": "DocusignIntegration",
"RevisionID": 872381127
}

{
"$id": "1",
"DownloadUrl":
"https://s3.amazonaws.com/bluebeam.studio.documents
/projects/ac5....0d7d5?AWSAccessKeyId=AIA3E5....
WX&Expires=1770257465&x-amz-security-token=xxxx",
"Id": 380657794,
"Name": "grid.pdf",
"Path": "/level1/grid.pdf",
"ParentFolderId": 380657776,
"Created": "2025-12-16T23:42:11.39976",
"Permission": "ReadWriteDelete",
"CRC": "90B707AA",
"Size": 3256,
"IsLocked": true,
"InSession": false,
"LockOwnerEmail": "DocusignIntegration@bluebeam.com",
"LockOwnerName": "DocusignIntegration",
"RevisionID": 2
}

 

GET /v1/projects/{projectId}/files/{fileId}

Before

After

{
"$id": "1",
"DownloadUrl":
"https://s3.amazonaws.com/bluebeam.studio.documents
/projects/269c72afe30547b9a3c0b81141ef2e87/7d1619
57d3314c67ae93bc9e1c283b8b?AWSAccessKeyId=xxxx",
"Id": 354537051,
"Name": "SampleDocument.pdf",
"Path": "/DemoFolder/SampleDocument.pdf",
"ParentFolderId": 354537038,
"Created": "2025-04-23T23:57:20.812851",
"Permission": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": true,
"InSession": false,
"LockOwnerEmail": "bbintegrationsdemo1@bluebeam.com",
"LockOwnerName": "BBIntegrations Demo1",
"RevisionID": 705422365
}

{
"$id": "1",
"DownloadUrl":
"https://s3.amazonaws.com/bluebeam.studio.documents
/projects/269c72afe30547b9a3c0b81141ef2e87/7d1619
57d3314c67ae93bc9e1c283b8b?AWSAccessKeyId=xxxx",
"Id": 354537051,
"Name": "SampleDocument.pdf",
"Path": "/DemoFolder/SampleDocument.pdf",
"ParentFolderId": 354537038,
"Created": "2025-04-23T23:57:20.812851",
"Permission": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": true,
"InSession": false,
"LockOwnerEmail": "bbintegrationsdemo1@bluebeam.com",
"LockOwnerName": "BBIntegrations Demo1",
"RevisionID": 2
}

 

GET /v1/projects/{projectId}/folders/{id}/items

Before

After

{
"$id": "1",
"ProjectFiles": [
{
"$id": "2",
"Id": 354537051,
"Name": "SampleDocument.pdf",
"Path": "/DemoFolder/SampleDocument.pdf",
"ParentFolderId": 354537038,
"Created": "2025-04-23T23:57:20.812851",
"Permission": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": true,
"InSession": false,
"LockOwnerEmail": "bbintegrationsdemo1@bluebeam.com",
"LockOwnerName": "BBIntegrations Demo1",
"RevisionID": 705422365
}
],
"ProjectFolders": [],
"TotalCount": 1
}

{
"$id": "1",
"ProjectFiles": [
{
"$id": "2",
"Id": 354537051,
"Name": "SampleDocument.pdf",
"Path": "/DemoFolder/SampleDocument.pdf",
"ParentFolderId": 354537038,
"Created": "2025-04-23T23:57:20.812851",
"Permission": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": true,
"InSession": false,
"LockOwnerEmail": "bbintegrationsdemo1@bluebeam.com",
"LockOwnerName": "BBIntegrations Demo1",
"RevisionID": 2
}
],
"ProjectFolders": [],
"TotalCount": 1
}

 

GET /v1/projects/{projectId}/files/{fileId}/revisions

Before

After

{
"$id": "1",
"ProjectFileRevisions": [
{
"$id": "2",
"Id": 705422176,
"Comment": "",
"CRC": "799548DA",
"OperationType": "Add",
"RevisionNumber": 872381127,
"RevisionRestorable": true,
"Size": 78207,
"Timestamp": "2025-04-23T23:57:22.23021",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"UserName": "BBIntegrations Demo1"
},
{
"$id": "3",
"Id": 705422365,
"Comment": "Signed from DocuSign",
"CRC": "00000000",
"OperationType": "CheckIn",
"RevisionNumber": 705422365,
"RevisionRestorable": false,
"Size": 0,
"Timestamp": "2025-04-23T23:59:29.535663",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"UserName": "BBIntegrations Demo1"
}
]
}

{
"$id": "1",
"ProjectFileRevisions": [
{
"$id": "2",
"Id": 1,
"Comment": "",
"CRC": "799548DA",
"OperationType": "Add",
"RevisionNumber": 1,
"RevisionRestorable": true,
"Size": 78207,
"Timestamp": "2025-04-23T23:57:22.23021",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"UserName": "BBIntegrations Demo1"
},
{
"$id": "3",
"Id": 2,
"Comment": "Signed from DocuSign",
"CRC": "00000000",
"OperationType": "CheckIn",
"RevisionNumber": 2,
"RevisionRestorable": false,
"Size": 0,
"Timestamp": "2025-04-23T23:59:29.535663",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"UserName": "BBIntegrations Demo1"
}
]
}

 

GET v1/projects/{projectId}/files/{fileId}/revisions/{id}

Before

After

{
"$id": "1",
"DownloadUrl":
"https://s3.amazonaws.com/bluebeam.studio.documents
/projects/269c72afe30547b9a3c0b81141ef2e87/7d1619
57d3314c67ae93bc9e1c283b8b?versionId=AU37klPj9j
ikuGgh3CzsQdXw7lt2pSDQ&AWSAccessKeyId=ASI
A3E5OIX5P4BM7EBVL&Expires=1770253559&x-
amz-security-token=IQoJb3JpZ2luXxxx",
"Id": 705422176,
"Comment": "",
"CRC": "799548DA",
"OperationType": "Add",
"RevisionNumber": 705422365,
"RevisionRestorable": true,
"Size": 78207,
"Timestamp": "2025-04-23T23:57:22.23021",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"UserName": "BBIntegrations Demo1"
}

{
"$id": "1",
"DownloadUrl":
"https://s3.amazonaws.com/bluebeam.studio.documents
/projects/269c72afe30547b9a3c0b81141ef2e87/7d1619
57d3314c67ae93bc9e1c283b8b?versionId=AU37klPj9j
ikuGgh3CzsQdXw7lt2pSDQ&AWSAccessKeyId=ASI
A3E5OIX5P4BM7EBVL&Expires=1770253559&x-
amz-security-token=IQoJb3JpZ2luXxxx",
"Id": 2,
"Comment": "",
"CRC": "799548DA",
"OperationType": "Add",
"RevisionNumber": 1,
"RevisionRestorable": true,
"Size": 78207,
"Timestamp": "2025-04-23T23:57:22.23021",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"UserName": "BBIntegrations Demo1"
}

Endpoints accepting RevisionID as input:

Method

Endpoint

Description

GET

/v1/projects/{projectId}/files/{fileId}/revisions/{id}

Get revision metadata

POST

/v1/projects/{projectId}/files/{fileId}/revisions/{id}/restore

Restore file to revision

Updates to Bluebeam API Licensing Access

Upgrade to Bluebeam Core or Complete to maintain create functionality through an integration

As part of our commitment to delivering the best possible experience through the Bluebeam Studio API, we retired licensing integrations entitlements on February 20, 2026.

What this means:

  • Integration users on Revu 20 can attend and collaborate in Studio Sessions and Projects through an integration but are not able to create them through an integration after February 20, 2026.

  • To continue creating Studio Sessions and Projects through an integration, users must upgrade to a Bluebeam Core or Complete subscription plan as of February 20, 2026.

Learn more about the Bluebeam subscription plans here: Subscription Features.

Markups API – Enhancements

Release access: Beta

  • Expands on Markups API V1, released in 2025, to new features listed below.

  • Adds read access to additional Markups List fields for richer markup context

  • Introduces access to markup change history

  • Released as a Beta; functionality and coverage may evolve

  • Updated Developer Portal documentation is now available

Markup Data

Markups API v1

Markups API v2

Markup identifiers:
markupID | documentId

- sessionId

Read only

Read only

email
ex., example@gmail.com

Read only

Read only

displayName
ex., test

Read only

Read only

Type
(ex., Line)

Read only

Read only

Subject
(ex., Arrow)

Read only

Read only

Subject

Read only

Read only

Created

Read only

Read only

Modified

Read only

Read only

Status

Read only

Read only

Lock

X

Read only

Page Number

X

Read only

Comments

X

Read only

Layer

X

Read only

Label

X

Read only

Measurement Data

X

Read only

Custom Column(s)

X

Read only

Geometry

X

Read only

Custom Statuses

X

Read only

StatusAuthor

X

X

StatusUpdated

X

X

Author*

X

Read only

Stamp

Read only

Read only

Resources

Revu 21

Bluebeam Integrations

Bluebeam Integrations

Use these resources to learn more about what Bluebeam integrations are, how to access integrations, and how to develop private or public integrations between Bluebeam and third-party software.