Get a UniFi API key for Blocker

Answers to common questions about Blocker.

Blocker talks to your router with a Local API Key. You create it once in UniFi OS, paste it into Blocker, and you're done. The key only works on your home network, and Blocker keeps it in your Keychain.

1. Open UniFi OS

On a computer, open your router's UniFi OS page in a browser. For most homes that's https://192.168.1.1 (or https://unifi on some routers). Your browser will warn about the certificate; that's normal for a device on your own network, so continue to the site.

Sign in with your Ubiquiti account, or the local admin account you made when you set up the router.

2. Go to Control Plane → Integrations

In the left sidebar, open Control Plane, then Integrations. (If you don't see Control Plane, open the Settings gear first. The name has moved around between UniFi OS versions, but it's always under the OS settings, not inside the Network app.)

3. Create a Local API Key

Click Create API Key. Give it a name you'll recognize later, like Blocker. Leave the expiration alone, or set it to never expire if you don't want to redo this step. Click Create.

UniFi shows the key once. Copy it right away.

4. Paste it into Blocker

Open Blocker and tap Connect Your Router (or Settings if you've been here before). Fill in:

  • Router: the same address you used in step 1, for example 192.168.1.1.
  • API Key: the key you just copied.
  • Site: leave it as default unless you've set up more than one site.

Tap Test Connection. Blocker says how many devices it can see on your network. Tap Save, then Add to pick the devices you want to control.

Having trouble?

  • "UniFi rejected the API key." The key was copied with a space at either end, or it expired. Create a new one and paste it again.
  • "Can't reach your router." Your iPhone or Mac isn't on your home Wi‑Fi, or the router address is wrong. Blocker works on your home network (or over a VPN into it).
  • "Couldn't find your router's Internal and External firewall zones." Blocker needs UniFi Network 9 or later with the zone-based firewall. Update the Network app in UniFi OS.

Still stuck? Email support@boringware.com with your router model and UniFi Network version.

Setting up a second person

You only need one API key per household. Once Blocker is set up on your device, tap Share in Blocker and AirDrop the setup to your partner's iPhone, iPad, or Mac. They open it in Blocker and they're done, with the same router and the same device list. See Blocker support for more.