Skip to main content
curl -X POST "$API_BASE_URL/v1/org/$ORG_ID/contexts/sign-in/$CTX_ID/modules/whitelistings" \
  -H "x-auth-token: $NETGRAPH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mac": "AA:BB:CC:DD:EE:FF",
    "name": "Reception printer",
    "description": "Lobby floor, left side",
    "toDate": "2026-12-31",
    "tags": [{ "value": "printer" }]
  }'

HTTP/1.1 200 OK
Whitelists one MAC address. A whitelisted device connects to the SSID and skips the Captive Portal.

​
Request

​
organizationId
string
required
Organization ID.
​
contextId
string
required
Sign-In Context ID.
​
x-auth-token
string
required
Context API key.
​
id
string
Optional UUID for the whitelist entry. Leave empty to let the backend generate one.
​
mac
string
required
Device MAC address. Accepted formats: AA:BB:CC:DD:EE:FF or AA-BB-CC-DD-EE-FF.
​
name
string
required
Device name. 2–100 characters. Allowed characters: a-z A-Z 0-9 å ä ö Å Ä Ö & - , . and space.
​
description
string
Free-form description, 0–200 characters. Same character set as name.
​
toDate
string (date)
Expiry date, YYYY-MM-DD. The entry is automatically removed at 00:00 Organization-local time on this date. Omit for a permanent entry.
​
tags
object[]
Optional tags for filtering in the admin UI.
​
createdBy
string
Optional creator identifier. Shown in the admin under the entry’s metadata.
curl -X POST "$API_BASE_URL/v1/org/$ORG_ID/contexts/sign-in/$CTX_ID/modules/whitelistings" \
  -H "x-auth-token: $NETGRAPH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mac": "AA:BB:CC:DD:EE:FF",
    "name": "Reception printer",
    "description": "Lobby floor, left side",
    "toDate": "2026-12-31",
    "tags": [{ "value": "printer" }]
  }'

​
Response

HTTP/1.1 200 OK