Events

Overview

Events track user actions. Use them to trigger workflows and update contact data.

Tracking

await fetch('/v1/track', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer pk_your_public_key'
  },
  body: JSON.stringify({
    event: 'signed_up',
    email: user.email,
    data: { plan: 'pro' }
  })
});

Creates/updates contact and records the event.

Keys

• Public key (pk_*): Safe for client-side, only works with /v1/track
• Secret key (sk_*): Server-side only, full API access

Event data

Persistent (default): Saved to contact

data: { plan: 'premium' }

Non-persistent: Available only to workflow

data: {
  orderId: { value: 'order-123', persistent: false }
}

Automatic events

Plunk tracks these automatically:

• email.sent, email.opened, email.clicked
• email.bounced, email.complained
• segment.entered, segment.exited