Skip to content
OpenAppPhysical access, simplified
Login

PalGate Cloud

Not for electrically locking a means of egress.OpenApp is ingress-only software. Occupants must be able to exit without this integration, the cloud, or a phone. SeeLife safety and egress.

  • Product: PalGate
  • Manufacturer: PAL Electronics Systems
  • Similar open-source integrations:
    • Home Assistant has many gate/relay integrations; use the one that matches your hardware and/or protocol.

Linking a PalGate account into an OpenApp organization delegates gate control to org operators. Coordinate with the gate owner and your organization’s policies before linking a personal phone. OpenApp probes whether the linked account is a gate administrator per device and surfaces warnings in the dashboard. See PalGate permissions and Linked Device for the full policy matrix.

  1. In Integrations, create a new integration and choose provider type PalGate Cloud.
  2. Enable Linked Device in the PalGate app for your phone on the target gate (gate administrator). Without this, QR linking fails with Secondary device not authorized. See Linked Device.
  3. Follow the setup wizard: enter the PalGate device id (and optional name), then scan the QR code with the PalGate app under Linked devices → Link a device. The dashboard polls the server until linking completes and fills session token, phone number, and token type automatically. The wizard probes admin status on that device; non-admin accounts may require legal acknowledgment depending on org policy.
  4. If you cannot use QR linking, use Enter credentials manually in the wizard to paste values (same fields as below).
  5. For each gate you want in OpenApp, create a device on that integration. Set PalGate gate ID (stored as external_id) to the PalGate device id string the API expects (for example DEVICE or DEVICE:2 for a second output). Device metadata stores linked-account role probes and optional legal acknowledgment. From the wizard review step you can open Devices with device id/name prefilled via query params.
  6. Trigger an OpenApp “open” action and confirm the gate opens.
  1. Create an integration with provider type palgate_cloud and set the config and secrets fields in the table below (or via POST /integrations with config + secrets).
  2. Continue from step 4 above.

For custom clients or automation, the same linking flow the wizard uses is available over HTTP (same auth as integrations; X-Org must match the org):

  • POST /api/v1/integration-setup/v1/sessions — body: { "flow": "palgate_cloud_device_link", "org_id": "<uuid>", "options": { "base_url": "..." } } (optional base_url). Returns session_id and a step payload with palgate_cloud_device_link.qr_payload (and linking metadata).
  • POST /api/v1/integration-setup/v1/sessions/{session_id}/poll — call repeatedly (e.g. every 1–2s). Responses: awaiting_scan, succeeded (includes config + secrets for the integration), or failed. Sessions expire after a short TTL (~15 minutes).

Use the returned config and secrets on POST /integrations to create the integration.

FieldTypeRequiredDescriptionDefaultExample
base_url
stringoptionalBase URL for the PalGate API.https://api1.pal-es.comhttps://api1.pal-es.com
session_token_hexSecrets Manager
stringrequiredSession token (hex) used to authenticate to PalGate Cloud.0a1b2c3d4e5f...
phone_number
numberrequiredPhone number associated with the PalGate account.15551234567
token_type
stringrequiredToken type string: sms, primary, or secondary.primary

Policies

Policies restrict access on top of roles — they never grant it. Browse the policy catalog for arguments and examples. Expand a category below to see the policies that apply to this integration, then expand a policy for details.

Because this provider exposes a verifiable hardware admin, a verified admin can also become the device steward and set the Device tier, which binds every org and integration pointing at the same physical device. See Regaining control of shared devices.

Invitations

Guest invites — duration, uses, who may create them, and which doors they can cover.

19 policies

Invitation curfew

Blocks invitation-based opens during a forbidden time window (for example nights).

Admins and residents are never curfewed; existing invitations are evaluated live, not modified.

Learn more — Invitation curfew
Enforced at
Access-time
Tiers
OrgIntegrationDevice
Default
Not configured — no hour restrictions on invitation-based access.
Enforcement
Enforce

Max invitation duration

Caps how long each invitation schedule slot may last.

Longer create or update requests are rejected, not shortened.

Learn more — Max invitation duration
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — no policy cap on invitation slot length.
Enforcement
Enforce

Max share duration

Caps how long a short-term share (TTL invitation) may last.

Combined with max invitation duration as the stricter of the two. Longer create requests are rejected, not shortened.

Learn more — Max share duration
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
System default is 86400 (1 day) when unset. Org policy may raise the share cap up to 31536000 (365d).
Enforcement
Enforce

Default share uses

When the author omits a use count on a share, store this default.

The system default is 1 when this policy is not configured.

Learn more — Default share uses
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — omitted share max_uses stores 1.
Enforcement
Enforce

Max share uses

Ceiling on how many times a share may be used.

Unlimited shares require allow_unlimited on every applicable row and no invitation_max_uses.

Learn more — Max share uses
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — no extra ceiling; unlimited shares remain forbidden.
Enforcement
Enforce

Max invitation uses

Requires a finite use count and rejects unlimited invitations or counts above the cap.

Learn more — Max invitation uses
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — unlimited-use invitations are allowed.
Enforcement
Enforce

Max invitation devices

Caps the number of unique guest browsers or app installations that may register an invitation.

Learn more — Max invitation devices
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — invitations may register any number of devices.
Enforcement
Enforce

Max active invitations per user

Caps how many enabled, unexpired invitations one person may have at once.

Learn more — Max active invitations per user
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — no cap on how many invitations one person may keep active.
Enforcement
Enforce

Require invitation expiry

Forbids open-ended recurring invitations that never end.

Learn more — Require invitation expiry
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — never-ending recurring invitations are allowed.
Enforcement
Enforce

Allowed entry kinds

Limits which portal types (door, gate, boom-gate) an invitation may grant.

Combination intersects allowed sets.

Learn more — Allowed entry kinds
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — any portal entry kind may be granted.
Enforcement
Enforce

Require invitation justification

Requires a non-empty creation justification when creating or updating an invitation.

Learn more — Require invitation justification
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — justification is optional.
Enforcement
Enforce

Max doors per invitation

Caps how many unique portals a single invitation may grant.

Learn more — Max doors per invitation
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — no policy cap on portals per invitation.
Enforcement
Enforce

Own-apartment doors only

Invitations may only grant doors the author can open as a resident of an allowed apartment.

Org/integration admins are exempt unless applies_to says otherwise. PalGate-only sites with no apartments fail for residents.

Learn more — Own-apartment doors only
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — invitations may grant any portal the author can otherwise share.
Enforcement
Enforce

Prohibit master-door invitations

Rejects an invitation if any granted portal’s door is a listed OpenApp device id (union of ids; never client-forged hardware ids).

Learn more — Prohibit master-door invitations
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — master doors may be granted on invitations.
Enforcement
Enforce

Who may invite

Literal allow-list of roles that may create invitations.

Combination intersects lists; empty intersection means nobody. Not admin-exempt. Compose with user_sharing (both must pass).

Learn more — Who may invite
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — anyone who can otherwise create invitations may do so.
Enforcement
Enforce

No invitation re-share

When the row binds the actor, invite create/update is rejected.

Org/integration default bind is resident (invitees), not generic members. Device-tier without applies_to binds everyone.

Learn more — No invitation re-share
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — invitees may create further invitations if their roles allow it.
Enforcement
Enforce

Require invitation identity

Requires a host PIN, a host-attached photo, and/or a verified invitee phone before an invitation can be created or used.

Learn more — Require invitation identity
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — PIN, photo, and verified phone are optional.
Enforcement
EnforceRequire approval

Invitation allowed days

Limits invitation-based opens to listed weekdays, minus blackout dates and optional holiday-calendar dates.

Existing invitations are evaluated live, not modified.

Learn more — Invitation allowed days
Enforced at
Access-time
Tiers
OrgIntegrationDevice
Default
Not configured — invitation-based access is not limited by weekday or blackout date.
Enforcement
Enforce

Holiday calendar

Lists organization-local ISO dates that invitation allowed-days can treat as holidays.

This type does not deny access by itself.

Learn more — Holiday calendar
Enforced at
Access-time
Tiers
OrgIntegrationDevice
Default
Not configured — no shared holiday date list.
Enforcement
Enforce

Holds

Door hold-open and hold-closed — who may set a hold and for how long.

5 policies

Require hold expiry

Members and residents cannot set a permanent hold.

Temporary (and unless also forbidden, weekly) holds are still allowed.

Learn more — Require hold expiry
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — permanent holds are allowed for anyone with the set-hold role.
Enforcement
Enforce

Max hold duration

Caps how long a temporary hold can last.

Longer requests are rejected, not shortened. PalGate hardware latch max is an extra cap when present.

Learn more — Max hold duration
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — no policy cap on temporary hold duration.
Enforcement
Enforce

No repeating holds

Members and residents may only set a one-shot hold, not a repeating calendar schedule.

Learn more — No repeating holds
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — repeating holds are allowed for anyone with set-hold.
Enforcement
Enforce

Allowed hold modes

Limits members and residents to hold-open, hold-closed, or both (for example, stay-off for lights but not stay-on).

Learn more — Allowed hold modes
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — both hold-open and hold-closed are allowed.
Enforcement
Enforce

No holds

Members and residents cannot set a hold, even if an admin granted the set-hold role.

Device-tier without applies_to binds everyone, including admins.

Learn more — No holds
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — anyone with the set-hold role may set a hold.
Enforcement
Enforce

Sharing

Who may share access or manage linked users outside invitations.

4 policies

User sharing control

Restricts whether non-admins may share access or create invitations out of band — block outright or require admin approval.

Learn more — User sharing control
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — non-admins may share access freely.
Enforcement
EnforceRequire approval

No transitive delegation

Invite create: org admin or apartment admin only.

Vendor users_admin writes (except list): org admin only. Runs in addition to user_sharing.

Learn more — No transitive delegation
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — ordinary role and user_sharing rules apply.
Enforcement
Enforce

Approval threshold

Requires N distinct organization-admin approve votes before a pending policy approval proceeds.

Any deny denies. Self-approval does not count.

Learn more — Approval threshold
Enforced at
Authoring-time
Tiers
OrgIntegrationDevice
Default
Not configured — a single admin approve or deny is enough.
Enforcement
Enforce

Linked-account admin

Controls whether a non-admin PalGate vendor account can complete setup: warn only, warn and require acknowledgment, or block until an admin account is used.

Learn more — Linked-account admin
Enforced at
Authoring-time
Tiers
Org
Default
Not configured — warn and require acknowledgment (historical PalGate default).
Enforcement
Enforce

Lifecycle

Move-out and idle membership — revoke leftover invites without deleting the user.

2 policies

Revoke invites on move-out

When a resident is removed from an apartment, enabled invitations they authored that grant that apartment’s doors are revoked.

Learn more — Revoke invites on move-out
Enforced at
Authoring-time
Tiers
OrgIntegration
Default
Not configured — leftover invitations stay enabled after move-out.
Enforcement
Enforce

Expire dormant users

After idle days, revoke that person’s invitations and remove residencies.

The user account is not deleted. Admins are exempt unless included.

Learn more — Expire dormant users
Enforced at
Authoring-time
Tiers
OrgIntegration
Default
Not configured — idle members and residents are not auto-expired.
Enforcement
Enforce

Agent safety

Time windows, throttles, and extra confirmation for agents, API keys, and guests.

4 policies

Quiet hours

Blocks access during a local hour window for listed principal kinds (agents, API keys, invitations).

Admins are not restricted unless included.

Learn more — Quiet hours
Enforced at
Access-time
Tiers
OrgIntegration
Default
Not configured — no quiet-hours window.
Enforcement
Enforce

Rate limit

Throttles entity opens per principal in a sliding window so retrying agents cannot exhaust door quota.

Learn more — Rate limit
Enforced at
Access-time
Tiers
OrgIntegration
Default
Not configured — no policy throttle on opens.
Enforcement
Enforce

Require step-up

Requires extra confirmation before a physical write for the listed principal kinds.

Learn more — Require step-up
Enforced at
Access-time
Tiers
OrgIntegration
Default
Not configured — no extra confirmation beyond ordinary authorization.
Enforcement
Enforce

Anti-tailgating cooldown

After a successful open of an entity, further opens of that entity are denied until the cooldown elapses.

Admins are exempt by default.

Learn more — Anti-tailgating cooldown
Enforced at
Access-time
Tiers
OrgIntegration
Default
Not configured — no per-door cooldown after a successful open.
Enforcement
Enforce

Operational

Site-wide lockdown and notifications when a policy denies access.

6 policies

Emergency lockdown

When active, denies non-admin inbound cloud opens.

Does not lock a means of egress or fire-door assembly, and is not a building lock-in.

Learn more — Emergency lockdown
Enforced at
Access-time
Tiers
Org
Default
Not configured — no lockdown.
Enforcement
Enforce

Emergency free egress

When active, OpenApp will not deny inbound cloud opens.

This is not fire-alarm release.

Learn more — Emergency free egress
Enforced at
Access-time
Tiers
Org
Default
Not configured — ordinary denies still apply.
Enforcement
Enforce

Notify on curfew attempt

Emits an audit event (and configured channels) when curfew blocks an open.

Learn more — Notify on curfew attempt
Enforced at
Denial hook
Tiers
OrgIntegration
Default
Not configured — curfew denials are not additionally notified.
Enforcement
Enforce

Maintenance window

During a local hour window, only listed roles may open.

Empty role intersection means nobody. Technicians match the same way as who-may-invite.

Learn more — Maintenance window
Enforced at
Access-time
Tiers
OrgIntegration
Default
Not configured — no technician-only maintenance window.
Enforcement
Enforce

Notify on first use

Emits an audit event when an invitation’s use count goes from 0 to 1, if audit is among the channels.

Learn more — Notify on first use
Enforced at
Access-time
Tiers
OrgIntegration
Default
Not configured — first invitation use is not additionally notified.
Enforcement
Enforce

Notify on new sharing

Emits an audit event after users_admin writes (except list) and after invitation create that actually shares, if audit is among the channels.

Learn more — Notify on new sharing
Enforced at
Authoring-time
Tiers
OrgIntegration
Default
Not configured — new sharing is not additionally notified.
Enforcement
Enforce

The PalGate provider exposes the users_admin capability, which lets OpenApp list and remove gate users directly from the PalGate device — without leaving the dashboard. This powers the Users tab on the integration detail page.

  • Handle kind: phone (PalGate identifies users by E.164 phone number).
  • Ops:
    • users_admin.list_users — returns the directory of phone numbers granted access to a single PalGate device. The op takes { device_id } (the PalGate device id, not the OpenApp device row id) and is auto-invoked by GET /integrations/{id}/integration-users once per integration device.
    • users_admin.remove_user — revokes a phone number from a PalGate device. Body: { device_id, handle } where handle is the user’s E.164 phone.

OpenApp permissions (gate operator vs access administrator)

Section titled “OpenApp permissions (gate operator vs access administrator)”
PermissionAction
integrations:readView integration, execute gate-open ops
integrations:users:listGET /integrations/{id}/integration-users, Users tab
integrations:users:writeInvite/resend/cancel in dashboard, users_admin.remove_user

The PalGate API still requires the linked phone to be a gate administrator to list or remove users on a device. When the linked account is not admin, the Users tab shows a limited state instead of a hard error. Full reference: PalGate permissions guide.

Org-tier policy type linked_account_admin (default warn_and_ack when unset):

ValueSetupUsers tab
warn_onlyAllow; show warningsFails to list if not PalGate admin
warn_and_ackNon-admin must accept acknowledgmentLimited directory when not admin
admin_onlyBlock if linked account is not admin on setup deviceFull users_admin when admin

This is authored in Settings → Policies, not org metadata. Who may share gate users is a separate user sharing policy. See Policies and the policy catalog.

Device-level policies (gate owner control)

Section titled “Device-level policies (gate owner control)”

A verified PalGate gate administrator can become the OpenApp device steward for a gate and set device-level policies (for example a curfew or sharing controls) that bind every organization and integration pointing at the same physical gate — even ones the steward cannot otherwise see. The gate identity is auto-detected and stewardship is verified against the real gate, so it cannot be spoofed. See Regaining control of shared devices.

GET /integrations/{id}/integration-users may include directory_limited: true when the upstream provider did not return the full user directory (for example the linked credentials lack provider-side admin rights). This field is provider-agnostic — PalGate-specific linked-account role details are in device metadata palgate_linked_account (refreshed via the palgate.probe_linked_account integration op).

/integrations/{id}/integration-users joins each PalGate-reported phone with the OpenApp users table and any pending user_invitations for the same org:

statusMeaning
linkedOpenApp user has a verified phone matching the gate entry — the dashboard shows a deep link.
invitedNo matching OpenApp user, but an open user_invitations row targets the same phone.
unlinkedNeither — the gate has a directory entry that OpenApp has never invited or attached. The Users tab flags these as unmanaged. OpenApp does not remove them automatically.
  • POST /integrations/{id}/ops/palgate.probe_linked_account — probe the linked account on one gate (payload.device_id = PalGate device id). Persists palgate_linked_account in the matching OpenApp device metadata.
  • POST /integration-setup/v1/palgate/probe-linked-account — wizard probe before integration exists (requires integrations:create).
  • No email handle: PalGate’s API only models phone-based access. The Users tab therefore hides the email column on PalGate integrations even though user_invitations itself supports both channels.
  • Per-device scope: PalGate users are scoped to a single device, so the Users tab aggregates per-device lists. Removing a phone from one device does not propagate to other PalGate devices in the same integration.
  • No display name: PalGate does not return a display name for directory entries. Rows render with an em-dash until OpenApp can resolve the phone to an existing user.