Optimize your integrations with Webhooks

Use Bluebeam’s API Webhooks (also known as Subscriptions) endpoints to subscribe to Studio updates so your app automatically receives changes, eliminating the need for manual polling.

Webhooks are a standard capability in the Bluebeam API and available to all integrations.

Webhook endpoints let you subscribe to activity and updates for Studio Projects or Sessions, enabling real-time integration triggers as events occur. By using Webhooks, you minimize the need for repeated polling—subscribe to the events you want to track and the API endpoints will send updates directly, helping reduce unnecessary API calls and improving overall system performance.

We're excited to see how you leverage Webhooks to enhance your integrations and create custom workflows with the Bluebeam API.

Event notifications

Type of Webhooks Events that trigger notifications
Session

  • Session level

    • Update (rename, update expiration date, finalize)

    • Delete

  • Session document level

    • Create
    • Delete
Project

  • Project level

    • Update (rename)

    • Delete

  • Project item level

    • Create
    • Update (move, rename, check in)
    • Delete

API endpoints

All endpoints require the following:

  • An Authorization header with a token from the Developer API

  • A client_id header

Example body:

copy 
{
    "sourceType": "project",
    "resourceId": "123-456-789",
    "callbackURI": {callback URI}
}

  • sourceType can be "session" or "project"

  • resourceID is either the Session or Project ID

  • callbackURI must be a vlid URI using https

Example response:

copy 
{
    "subscriptionId": "0476edcf-e0e5-4242-8203-ad1770f4f059",
    "resourceId": "123-456-789",
    "sourceType": "project",
    "creatorEmail": {email},
    "clientId": {client id},
    "subscriptionStatus": "active",
    "created": "2025-06-16T15:50:20.831973204Z",
    "updated": "2025-06-16T15:50:20.831973204Z",
    "callbackURI": {callback URI}
}

 

Updates the callbackURI of a subscription.

Example body:

copy 
{
    "subscriptionId": "0476edcf-e0e5-4242-8203-ad1770f4f059",
    "callbackURI": {new callback URI}
}

Example response:

copy 
{
    "subscriptionId": "0476edcf-e0e5-4242-8203-ad1770f4f059",
    "resourceId": "123-456-789",
    "sourceType": "session",
    "creatorEmail": {email},
    "clientId": {client id},
    "subscriptionStatus": "active",
    "created": "2025-06-16T15:50:20.831973204Z",
    "updated": "2025-06-16T15:53:30.274499919Z",
    "callbackURI": {new callback URI}
}

 

Returns a list of all subscriptions available to the user.

Example response:

copy 
{
    "subscriptions": [
        {
            "subscriptionId": "0476edcf-e0e5-4242-8203-ad1770f4f059",
            "resourceId": "123-456-789",
            "sourceType": "session",
            "creatorEmail": {email},
            "clientId": {client id},
            "subscriptionStatus": "active",
            "created": "2025-06-16T15:50:20.831973204Z",
            "updated": "2025-06-16T15:53:30.274501793Z",
            "callbackURI": {callback URI}
        },
        {
            "subscriptionId": "f4b3a7b5-4b4c-47af-b1c2-3493255fc26d",
            "resourceId": "987-654-321",
            "sourceType": "project",
            "creatorEmail": {email},
            "clientId": {client id},
            "subscriptionStatus": "disabled",
            "created": "2025-05-13T19:21:00.736687777Z",
            "updated": "2025-06-05T14:37:15.546528614Z",
            "callbackURI": {callback URI}
        }
    ]
}

 

Returns information about a single subscription.

Example response:

copy 
{
    "subscriptionId": "0476edcf-e0e5-4242-8203-ad1770f4f059",
    "resourceId": "123-456-789",
    "sourceType": "session",
    "creatorEmail": {email},
    "clientId": {client id},
    "subscriptionStatus": "active",
    "created": "2025-06-16T15:50:20.831973204Z",
    "updated": "2025-06-16T15:53:30.274501793Z",
    "callbackURI": {callback URI}
}

 

Sets a subscription's status to "disabled".

Returns a 204 No Content.

Example callbacks

copy 
{
  "Source": "Studio",
  "ResourceID": "123-456-789",
  "ResourceType": "SessionDocuments",
  "Timestamp": "2025-06-16T15:58:44.2265563Z",
  "User": {email},
  "EventType": "Create",
  "IdPath": "null",
  "Path": "null",
  "ItemType": "null",
  "Name": "test.pdf"
}

 

copy 
{
  "Source": "Studio",
  "ResourceID": "123-456-789",
  "ResourceType": "Sessions",
  "Timestamp": "2025-06-16T15:59:31.2323589Z",
  "User": {email},
  "EventType": "Update",
  "IdPath": "null",
  "Path": "null",
  "ItemType": "null",
  "Name": "newSessionName"
}

 

copy 
{
  "Source": "Studio",
  "ResourceID": "987-654-321",
  "ResourceType": "ProjectItems",
  "Timestamp": "2025-06-16T16:01:56.8371219Z",
  "User": {email},
  "EventType": "Update",
  "IdPath": "/17484067/17572477",
  "Path": "/level1/test.pdf",
  "ItemType": "File",
  "Name": "test.pdf"
}

 

copy 
{
  "Source": "Studio",
  "ResourceID": "987-654-321",
  "ResourceType": "Projects",
  "Timestamp": "2025-06-16T16:03:40.0220965Z",
  "User": {email},
  "EventType": "Delete",
  "IdPath": "null",
  "Path": "null",
  "ItemType": "null",
  "Name": "testProject"
}

 

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

Use Bluebeam’s API Webhooks (also known as Subscriptions) endpoints to subscribe to Studio updates so your app automatically receives changes, eliminating the need for manual polling.