Birrdi's PIN Code Webhook can send manually assigned PIN codes, not just PIN codes generated through a supported access control integration.
The webhook is intended for specialized custom automation setups where a facility specifically needs to send the PIN code assigned to a reservation to another system.
Most facilities do not need to use the PIN Code Webhook. It should only be configured when your own access control, automation, or facility management system specifically needs to receive the reservation PIN.
The webhook does not generate, create, rotate, expire, or delete PIN codes. It only sends a PIN code that has already been assigned to the reservation.
How It Works
When a PIN code is assigned to a reservation, Birrdi can send the PIN code and reservation information to your configured webhook URL.
This works when the PIN code is:
Automatically generated by a supported access control integration
Manually assigned to the reservation in Birrdi
You do not need to use an automated access control integration for the webhook to send a manually assigned PIN.
However, the webhook should only be used when another system at your facility specifically needs to receive that PIN code.
Configure the PIN Code Webhook
If your custom automation requires reservation PIN codes, you can configure the webhook in Birrdi.
In Birrdi Admin, go to Simulators from the top navigation.
Click Settings next to your simulator.
From the left sidebar under Access Control, select Webhooks.
Enter the webhook URL where you want Birrdi to send PIN code information.
For example:
https://example.com/hooks/birrdi/pin-code
Manually Assign a PIN Code
When managing a reservation in Birrdi, manually assign the PIN code you want associated with the reservation.
Once the PIN code is assigned, Birrdi will send an HTTP POST request to your configured webhook URL.
The request will contain information similar to:
{ "name": "John Smith", "bay": "Bay 1", "summary": "John Smith Bay 1", "pin_code": "445789", "start_date": "2026-08-09T18:00:00-04:00" }Your receiving system determines what, if anything, should happen with the pin_code value.
Birrdi does not use the webhook to create or manage that PIN in your external system.
When Should I Use This?
The PIN Code Webhook is intended for the relatively small number of facilities that have a custom system requiring the PIN assigned to a Birrdi reservation.
For example, you may use it to:
Send an assigned PIN to your own facility management system
Pass the PIN to custom access control software
Trigger a custom workflow that specifically depends on the reservation PIN
Store the PIN in another internal system
Include the PIN as part of a larger custom facility automation
The webhook should not be treated as the standard way to automate access control or facility equipment.
If your automation only needs to know when reservations start and end, which bay is reserved, or who the reservation belongs to, you usually do not need the PIN Code Webhook.
For those types of automations, use Birrdi's Google Calendar integration instead.
Using This with Google Calendar
For facilities with a specialized automation that requires both reservation timing and the assigned PIN, the PIN Code Webhook can be used alongside Birrdi's Google Calendar integration.
In this setup:
Google Calendar provides reservation schedules and timing
PIN Code Webhooks provide the PIN already assigned to the reservation
For most custom facility automations, Google Calendar alone is sufficient.
Only add the PIN Code Webhook if your system specifically needs the reservation PIN itself.
See Automating More of Your Facility Beyond the Launch Monitor for more information.