Granting Third-Party Access to User Installations
This guide explains how third parties can request access to user installations, allowing seamless integration without requiring users to log in each time. This is especially useful when a partner needs to control an installation on behalf of a user. Once granted access, the partner can manage the installation in future integrations.
Using a Lookup Key to Request Access
Zaptec provides a lookup key that allows partners to prompt users to grant access to their installations.
- The lookup key is linked to a UserGroup and can be found under the Details tab of a UserGroup entry.
- If you do not have access to this section, please contact your Zaptec representative for assistance.
Creating an Access Request URL
Using the lookup key, you can generate a URL to prompt the user for authentication:
URL format:
https://portal.zaptec.com/access/request/<lookup key>
Replace <lookup key> with the actual lookup key from the UserGroup.
This flow currently applies only to Zaptec Home and Zaptec Go installations. If implementing for a Zaptec Pro installation, the
installationIdmust be included in the parameters.
Optional URL Parameters
You can customize the access request by adding parameters to the URL:
| Parameter | Description |
|---|---|
| lookup | The lookup key of the UserGroup requesting permission. The group name will be shown after login. |
| partnerName | The name displayed before the user logs in, indicating who is requesting access. |
| lang | Specifies the language for the process. |
| installationId | Pre-selects a specific installation for the access request. |
| installationtype | Defaults to 1 (Zaptec Go). Set to 0 to search for Zaptec Pro. |
| returnUrl | Defines where the user is redirected after the process. If not provided, Zaptec's built-in receipt page is used. |
| success | Indicates whether access was granted (true or false). |
| showExisting | Set to "true" to display all installations the user has access to, even if access was already granted. Defaults to "false". |
Important: We do not check user group details before login. To ensure clarity, always include the partnerName when opening the access request view. Once the user logs in, the proper UserGroup name will be displayed.
Here’s an example of a properly formatted access request URL:
https://portal.zaptec.com/access/request/BSJG?partnerName=Integration&lang=en&returnUrl=https://yourapp.com/access-result&installationtype=1
This will prompt the user to log in and grant access under the Integration partner name.
Updated 5 days ago