Webhooks

Webhooks notify your application when events happen in MeetLogin — for example, when a profile starts or stops.

Available Events

• profile.started — A browser profile was launched.
• profile.stopped — A browser profile was stopped.
• profile.sync_complete — Profile data finished syncing to the cloud.
• subscription.updated — Billing plan changed.

Payload Format

{
  "event": "profile.started",
  "timestamp": "2026-04-21T12:00:00Z",
  "data": {
    "profileId": "abc123",
    "profileName": "Amazon Account 1",
    "workspaceId": "ws456"
  }
}

Signature Verification

Each webhook includes an X-MeetLogin-Signature header — an HMAC-SHA256 of the request body signed with your webhook secret. Verify this in your endpoint to ensure the request is genuine:

const crypto = require('crypto')
const sig = req.headers['x-meetlogin-signature']
const expected = crypto
  .createHmac('sha256', WEBHOOK_SECRET)
  .update(req.rawBody)
  .digest('hex')
if (sig !== expected) return res.status(401).send('Invalid signature')

Configuring Webhooks

Go to Settings → API → Webhooks. Enter your endpoint URL and select which events to receive. We'll send a test event when you save.