igloohome Documentation

Welcome to the igloohome API documentation. igloohome is a revolutionary smart access solution that supports both online and offline access needs. Our patented AlgoPIN technology allows you to grant access without WiFi or cellular data.

This API exposes a number of functionalities supported on the igloohome app, such as:

AlgoPIN codes
Remote control via a Bridge
Notifications via Webhooks

HTTP Request Header Format

Key	Value
Authorization	`Bearer {access_token}`
Content-Type	`application/json`

See Getting Started with igloohome API (build for yourself) or Getting Started with iglooconnect (build for others) on how to get an access token.

The igloohome API supports JSON only. Set Accept and Content-Type to application/json.

<METHOD> <URL> HTTP/1.1
Accept: application/json
Content-Type: application/json

Example cURL:

curl -X POST -H "Authorization: Bearer {access_token}"  -H "Accept: application/json" -H "Content-Type: application/json"

Architecture

igloohome supports two integration paths depending on who is authenticating:

	Build for yourself	Build for others
Flow	OAuth 2.0 Client Credentials	OAuth 2.0 Authorization Code
Who authenticates	Your own account	Each end user, individually
Guide	igloohome API	iglooconnect

Your server to our server

Server-to-server integrations (no end user login) use the OAuth 2.0 Client Credentials flow via igloohome API — build for yourself. Your backend authenticates directly with its own Client ID and Secret. See Getting Started with igloohome API.

sequenceDiagram participant Y as Your Server participant O as Our Server Note over O: igloohome API Y->>O: HTTP Request O-->>Y: HTTP Response

Bridge-connected devices

Devices behind a Bridge are controlled through asynchronous remote jobs: your server queues a job (lock, unlock, create PIN) against the Bridge, and the Bridge executes it against the device and reports status back via webhook.

sequenceDiagram participant Y as Your Server participant O as Our Server participant B as Bridge participant D as Device Note over O: igloohome API Y->>O: Request O->>B: Request (WiFi) B->>D: Request (Bluetooth) D-->>B: Response B-->>O: Response O-->>Y: Response