← All Connectors
MyWiFi Networks

MyWiFi Networks

mywifi

White-label captive portal platform. Receives webhook events when guests authenticate through a captive portal, including email capture and social login data.

Configuration schema

FieldTypeRequiredDescription
api_keystringYesMyWiFi API key from your reseller dashboard.
location_idstringYesMyWiFi location ID for the venue.
webhook_secretstringNoHMAC secret for validating incoming webhook payloads.

Setup instructions

1

Log into your MyWiFi reseller dashboard.

2

Navigate to Settings > API and generate an API key.

3

Note the Location ID from the location settings page.

4

Register the integration via POST /api/venues/:id/integrations with connector_type "mywifi".

5

Configure a webhook in MyWiFi pointing to your /ingest endpoint.

Webhook / polling format

mywifi-webhook.json
{
  "event": "guest_authenticated",
  "location_id": "loc_123456",
  "guest": {
    "email": "guest@example.com",
    "auth_method": "social_google",
    "first_name": "Jane"
  },
  "device": {
    "mac": "aa:bb:cc:dd:ee:ff",
    "os": "Android"
  },
  "timestamp": "2026-03-15T17:00:00Z"
}

Normalized canonical event

After normalization, the connector output becomes a standard GNCanonicalEvent:

canonical-event.json
{
  "event_type": "device_connected",
  "venue_id": "v_ghi789",
  "zone_id": null,
  "device_hash": "hmac_sha256_e5f6a7b8c9d0",
  "timestamp": "2026-03-15T17:00:00.000Z",
  "connector_type": "mywifi",
  "metadata": {
    "auth_method": "social_google",
    "captive_portal": true
  }
}

Next steps