Webhook Events

All events that can trigger webhook notifications.

Event Types

Event	Description
card.created	New card synced from MAES
card.activated	Card was activated
card.enabled	Fuel authorizations enabled
card.disabled	Fuel authorizations disabled
card.synced	Card data synced from MAES
sync.completed	Full sync completed successfully
sync.failed	Sync operation failed
test	Test event for verification

Event Payload Format

All events follow this structure:

{
  "id": "evt_1a2b3c4d5e6f",
  "event": "event.type",
  "created_at": "2025-12-27T16:24:05.712Z",
  "data": {
    // Event-specific data
  }
}

Card Events

card.created

Triggered when a new card is synced from MAES.

{
  "id": "evt_abc123",
  "event": "card.created",
  "created_at": "2025-12-27T16:24:05.712Z",
  "data": {
    "card_id": "09c9861c-4c4b-411f-be85-c16ed7e26da4",
    "card_number": "782521009000153700",
    "status": "new",
    "environment": "production"
  }
}

card.activated

Triggered when a card is activated.

{
  "id": "evt_abc123",
  "event": "card.activated",
  "created_at": "2025-12-27T16:24:05.712Z",
  "data": {
    "card_id": "09c9861c-4c4b-411f-be85-c16ed7e26da4",
    "card_number": "782521009000153700",
    "license_plate": "AB-123-CD",
    "driver": "John Doe",
    "status": "active",
    "auth_gasoline": true,
    "auth_diesel": true,
    "auth_lpg": true,
    "auth_heating_oil": true,
    "environment": "production"
  }
}

card.enabled

Triggered when fuel authorizations are enabled.

{
  "id": "evt_abc123",
  "event": "card.enabled",
  "created_at": "2025-12-27T16:24:05.712Z",
  "data": {
    "card_id": "09c9861c-4c4b-411f-be85-c16ed7e26da4",
    "card_number": "782521009000153700",
    "license_plate": "AB-123-CD",
    "driver": "John Doe",
    "status": "active",
    "auth_gasoline": true,
    "auth_diesel": true,
    "auth_lpg": true,
    "auth_heating_oil": true,
    "environment": "production"
  }
}

card.disabled

Triggered when fuel authorizations are disabled.

{
  "id": "evt_abc123",
  "event": "card.disabled",
  "created_at": "2025-12-27T16:24:05.712Z",
  "data": {
    "card_id": "09c9861c-4c4b-411f-be85-c16ed7e26da4",
    "card_number": "782521009000153700",
    "license_plate": "AB-123-CD",
    "driver": "John Doe",
    "status": "inactive",
    "auth_gasoline": false,
    "auth_diesel": false,
    "auth_lpg": false,
    "auth_heating_oil": false,
    "environment": "production"
  }
}

card.synced

Triggered when card data is synced from MAES.

{
  "id": "evt_abc123",
  "event": "card.synced",
  "created_at": "2025-12-27T16:24:05.712Z",
  "data": {
    "card_id": "09c9861c-4c4b-411f-be85-c16ed7e26da4",
    "card_number": "782521009000153700",
    "sync_status": "synced",
    "environment": "production"
  }
}

Sync Events

sync.completed

Triggered when a full project sync completes successfully.

{
  "id": "evt_abc123",
  "event": "sync.completed",
  "created_at": "2025-12-27T16:24:05.712Z",
  "data": {
    "project_id": "project-uuid",
    "cards_synced": 50,
    "cards_created": 2,
    "cards_updated": 48,
    "duration_ms": 15000
  }
}

sync.failed

Triggered when a sync operation fails.

{
  "id": "evt_abc123",
  "event": "sync.failed",
  "created_at": "2025-12-27T16:24:05.712Z",
  "data": {
    "project_id": "project-uuid",
    "error": "Failed to authenticate with MAES portal",
    "error_code": "maes_auth_failed"
  }
}

Test Event

test

Used for webhook verification.

{
  "id": "evt_test_123",
  "event": "test",
  "created_at": "2025-12-27T16:24:05.712Z",
  "data": {
    "message": "This is a test webhook event"
  }
}