PointGrab sensor data - Integration guide
PointGrab is a peoneer in AI-powered occupancy sensing for commercial real estate and workplace optimisation. Its CogniPoint platform uses ceiling-mounted sensors and cloud analytics to provide accurate, privacy-compliant insights into space usage. Trusted by global organisations, PointGrab helps optimise hybrid workplaces and real estate portfolios while meeting high security and compliance standards, including GDPR and EU Cyber Resilience Act requirements.
PointGrab sensors provide real-time occupancy data that validates booking information from GoBright desk and room booking systems. This helps facilities teams distinguish between genuinely underused spaces and areas that are simply not being booked efficiently, enabling better decisions on workspace reconfiguration, downsizing, or expansion. You can read more about this partneship here.
Access to the PointGrab environment requires a Manager or Administrator account, as only users with the appropriate permissions can access and manage sensor configurations. It is important to ensure that the correct access rights are assigned, since restricted roles may not provide full visibility of the required data.
For the integration, PointGrab sensor Area IDs are required. These identifiers can be retrieved through the Swagger interface (Step 3 of this article), which provides structured access to the system’s API endpoints and available sensor data. Using this interface, you can locate and extract the relevant Area IDs needed to correctly configure and connect the sensors with external systems.
PointGrab provides two event types for GoBright:
- Room, desk of park occupancy
- People counting (not supported yet)
Connect PointGrab sensor data to GoBright in 4 steps
- Sign in at https://platform.pointgrab.com and generate ID and KEY
- Set up the Integration in the GoBright portal
- Retrieve the PointGrab Area ID’s from Swagger
- Couple an individual PointGrab Area to a specific GoBright Resource
Step 1: Sign in at https://platform.pointgrab.com to generate ID and KEY
- Sign in at https://platform.pointgrab.com and generate ID and KEY.
- Navigate to Management on the left-hand side (1).
- Then to USER MANAGER (2).
- And select Add App (3).
- In the Application details fill in field on the right-hand side, Give the Application a name (4) and choose role ‘Commissioner’ (5) and click on ‘Accessible Assets’ (6).
- Under User Assigned Assets choose GoBright Customer and make sure the checkmarks below that are all ticked (7).
- Press Save and the ID and KEY you need to fill in the GoBright Portal are generated (8). Copy/paste then in a safe place, your KEY will not be visible anymore once you close this screen.
Step 2: Set up the Integration in GoBright portal
- In the GoBright Portal, at the right top, navigate to the Admin center.
- Select Integrations and press the Add button.
- Give the integration a name (5) and in the External system pulldown menu choose Sensoring PointGrab (6)
- Copy/paste the saved ID and KEY in the PointGrab Application ID (7) and PointGrab Application KEY (8) fields and press Save (9).
- Make sure your integration is Active (9).
Step 3: Obtain the PointGrab Area ID’s from Swagger
- Open https://cpms.pointgrab.com/be/swagger-ui/index.html# and press the Authorize button.
- Log in with the PointGrab Application ID and the PointGrab Application Key (the same as used for the integration) , check the READ checkmark and press Authorize.
- Press Close.
- Scroll down to Sites, open GET /cp/v3/sites – Get all sites and press Try it out.
- Press Execute and from the response body copy the “id” value.
- Scroll down to Areas and open GET /cp/v3/sites//buildings/areas – Get all areas of given building, Press Try it out and paste the siteId value in the siteId value field.
- Scroll up and under Buildings open GET /cp/v3/sites//buildings – Get all buildings of a given site, press Try it out, paste the siteId in the siteId field and press Execute.
- From the response body copy the “id” of the building.
- Scroll down to areas and paste the buildingId in the buildingId field and press Execute.
- Copy the Area id’s from the response body to a safe temporarily place or paste them directly in your GoBright Portal as described in the next steps.
Step 4: Couple an individual PointGrab Area with a specific GoBright Resource
- In the GoBright Portal, at the right top, navigate to Meet-Work-Visit.
- Navigate to Settings – Devices.
- Navigate to Sensors and press Add.
- Select the room/desk/park to couple (7) and choose PointGrab sensor under Type (8).
- Paste the corresponding Area Id retrieved from the PontGrab Swagger respond and press Save.
- In the same manner add all your PointGrab sensors to the corresponding rooms/desks/parks.
- Enjoy your PointGrab occupancy detection in your GoBright system!