Teebly Docs2N Integration
Integration guide for 2N with Teebly
Overview
2N is a provider of IP intercoms and access control solutions. With the Teebly integration, you can offer your customers a unified experience for booking and autonomously accessing your indoor golf facility.
Prerequisites
Important: To connect 2N devices to Teebly, you must use a Company Admin account with multi-factor authentication (MFA) disabled.
If MFA is required for your admin account, create a separate account without MFA dedicated for this integration.
You will need the following before starting the integration:
- A My2N account with Company Admin access (with MFA disabled)
- One or more supported 2N devices added to your My2N account
- Remote API Access (RAA) enabled for your company
- HTTP API enabled for each device you want to connect
- Teebly account with administrator access
Prepare Your My2N Account
Step 1: Create a My2N Account
If you don't already have one, sign up for a My2N account.
Step 2: Add Your 2N Devices
In My2N, add your 2N IP devices to the account.
Step 3: Enable Remote API Access (RAA)
Make sure Remote API Access (RAA) is enabled for your company. If it's not enabled, contact integrations@2n.com to activate it. You'll need to provide your company ID, which can be found in the URL of your My2N dashboard.
Enable HTTP API for Each Device
Repeat the following steps for each 2N device you want to control through Teebly.
Step 1: Open Device Configuration
- In My2N, go to Devices in the left sidebar
- Click the three-dot icon next to your device and choose Open configuration
- When prompted, log in with the device's credentials. If you haven't set up specific credentials for the device, use the default:
- Default username:
Admin - Default password:
2n
- Default username:
Step 2: Enable HTTP API Services
- In the device dashboard, click Services
- From the sidebar, select HTTP API
- On the Services tab, ensure all APIs are enabled with:
- Connection Type set to Secure (TLS)
- Authentication set to Digest
Step 3: Create API Credentials
- In the top toolbar, click on Account 1, or another available account
- Enable the account
- Create a Username and Password
- In the User Privileges section, ensure both Monitoring and Control boxes are checked for all listed options
- Click the Save (💾) icon in the bottom-right corner to confirm
Important: Save these credentials securely. You'll need the Username and Password created in this step when connecting your device to Teebly.
Connect Your Devices to Teebly
Once your My2N account and devices are properly configured, you can connect them to Teebly.
Step 1: Access the Connection Flow
- Log into the Teebly Dashboard
- Navigate to Operations > Access Control
- Click Add devices
- Select 2N from the list of available access control providers
Step 2: Enter Your Company Admin Credentials
Enter your My2N Company Admin email and password, then click Submit.
Remember: Use an account with multi-factor authentication (MFA) turned off. If your main admin account requires MFA, create a separate account without MFA for this connection.
Step 3: Select Devices to Connect
The connection flow will show all 2N devices under your My2N company.
If a device doesn't appear, verify that:
- It has been added to your My2N account
- HTTP API is enabled for the device
- Remote API Access (RAA) is enabled for your company
Select the devices you want to connect to Teebly, then click Submit.
Step 4: Authorize Device Access
For each selected device, enter the Username and Password you created in Step 3.
This authorizes Teebly to securely communicate with your 2N devices.
Testing Your Integration
This will send a live unlock command to the selected 2N device. Ensure that it is safe to do so before proceeding.
After connecting your devices in Teebly, test that the unlock functionality works as expected:
- Navigate to Operations > Access Control
- Click the Test active device button
If the test is successful and your device unlocks, your integration is complete! Your customers will now be able to access your facility during their bookings.
Monitoring Access Requests
Teebly logs all access requests for monitoring and troubleshooting purposes. You can find access requests for the last 30 days by navigating to Operations > Door Access Logs.
Logs are also accessible within individual booking details and are not limited to the last 30 days.
Note: All requests with a "Granted" status indicate that Teebly authorized the request and sent an unlock command to the door reader.
This does not guarantee that the device has received or successfully processed the unlock command. Factors such as network connectivity, device functionality, or physical obstructions at the door may prevent the door from unlocking.
Troubleshooting
Device Not Appearing in Connection Flow
If your device doesn't appear when connecting to Teebly:
- Verify the device is added to your My2N account
- Confirm HTTP API is enabled for the device
- Check that Remote API Access (RAA) is enabled for your company
Connection Fails During Setup
If you encounter connection errors:
- Verify your My2N Company Admin credentials are correct
- Ensure MFA is disabled for the account you're using
- Confirm the device API credentials (username/password) are correct
- Check that all HTTP APIs are enabled with Secure (TLS) connection type
Device Won't Unlock
If the test unlock command fails:
- Verify the device is online in My2N
- Check that the API credentials have both Monitoring and Control privileges
- Ensure the device has a stable network connection
- Try logging into the device configuration in My2N to verify it's responding
Need additional help?
If you're still experiencing issues:
- 2N hardware or My2N account issues: Contact 2N Support for help with device functionality or My2N account configuration
- Teebly integration issues: Contact Teebly Support for help connecting 2N to your Teebly dashboard