Webhook Event Types

Renta sends 14 event types covering bookings, payments, deposits, customers, fleet, and waivers.

Booking Events

booking.created

Fired when a new booking is created.

{
  "id": "evt_001",
  "type": "booking.created",
  "data": {
    "id": "bk_def456",
    "status": "pending",
    "customer_id": "cust_abc",
    "pickup_date": "2026-07-01T09:00:00Z",
    "return_date": "2026-07-03T17:00:00Z",
    "subtotal": 10000,
    "tax_amount": 800,
    "total": 10800,
    "line_items": [
      {
        "fleet_item_id": "fi_abc123",
        "fleet_item_name": "Trail Blazer 500",
        "quantity": 1,
        "line_total": 10000
      }
    ]
  },
  "tenant_id": "tenant_xyz",
  "created_at": "2026-03-31T12:00:00Z"
}

booking.confirmed

Fired when a booking status changes to confirmed (typically after payment).

{
  "id": "evt_002",
  "type": "booking.confirmed",
  "data": {
    "id": "bk_def456",
    "status": "confirmed",
    "customer_id": "cust_abc",
    "amount_paid": 10800,
    "amount_owed": 0
  },
  "tenant_id": "tenant_xyz",
  "created_at": "2026-03-31T12:05:00Z"
}

booking.cancelled

Fired when a booking is cancelled.

{
  "id": "evt_003",
  "type": "booking.cancelled",
  "data": {
    "id": "bk_def456",
    "status": "cancelled",
    "customer_id": "cust_abc",
    "reason": "Customer requested cancellation due to weather",
    "total": 10800
  },
  "tenant_id": "tenant_xyz",
  "created_at": "2026-03-31T14:00:00Z"
}

booking.completed

Fired when a booking is marked as completed (rental returned).

{
  "id": "evt_004",
  "type": "booking.completed",
  "data": {
    "id": "bk_def456",
    "status": "completed",
    "customer_id": "cust_abc",
    "total": 10800,
    "pickup_date": "2026-07-01T09:00:00Z",
    "return_date": "2026-07-03T17:00:00Z"
  },
  "tenant_id": "tenant_xyz",
  "created_at": "2026-07-03T17:30:00Z"
}

booking.extended

Fired when a booking's return date is extended.

{
  "id": "evt_005",
  "type": "booking.extended",
  "data": {
    "id": "bk_def456",
    "previous_return_date": "2026-07-03T17:00:00Z",
    "new_return_date": "2026-07-05T17:00:00Z",
    "previous_total": 10800,
    "new_total": 21600
  },
  "tenant_id": "tenant_xyz",
  "created_at": "2026-07-02T10:00:00Z"
}

Payment Events

payment.received

Fired when a payment is successfully processed.

{
  "id": "evt_006",
  "type": "payment.received",
  "data": {
    "booking_id": "bk_def456",
    "payment_intent_id": "pi_stripe_abc123",
    "amount": 10800,
    "application_fee": 270,
    "currency": "usd"
  },
  "tenant_id": "tenant_xyz",
  "created_at": "2026-03-31T12:02:00Z"
}

Deposit Events

deposit.held

Fired when a deposit authorization hold is placed.

{
  "id": "evt_007",
  "type": "deposit.held",
  "data": {
    "deposit_hold_id": "dep_abc123",
    "booking_id": "bk_def456",
    "amount": 15000,
    "status": "held"
  },
  "tenant_id": "tenant_xyz",
  "created_at": "2026-03-31T12:03:00Z"
}

deposit.captured

Fired when a deposit hold is captured (charged).

{
  "id": "evt_008",
  "type": "deposit.captured",
  "data": {
    "deposit_hold_id": "dep_abc123",
    "booking_id": "bk_def456",
    "captured_amount": 5000,
    "original_hold_amount": 15000,
    "status": "partial_captured"
  },
  "tenant_id": "tenant_xyz",
  "created_at": "2026-07-03T18:00:00Z"
}

deposit.released

Fired when a deposit hold is released (no charge).

{
  "id": "evt_009",
  "type": "deposit.released",
  "data": {
    "deposit_hold_id": "dep_abc123",
    "booking_id": "bk_def456",
    "amount": 15000,
    "status": "released"
  },
  "tenant_id": "tenant_xyz",
  "created_at": "2026-07-03T18:00:00Z"
}

Customer Events

customer.created

Fired when a new customer is created.

{
  "id": "evt_010",
  "type": "customer.created",
  "data": {
    "id": "cust_abc",
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+1234567890"
  },
  "tenant_id": "tenant_xyz",
  "created_at": "2026-03-31T11:00:00Z"
}

customer.updated

Fired when customer information is updated.

{
  "id": "evt_011",
  "type": "customer.updated",
  "data": {
    "id": "cust_abc",
    "changes": {
      "name": { "from": "John Doe", "to": "John Smith" },
      "tags": { "from": [], "to": ["vip"] }
    }
  },
  "tenant_id": "tenant_xyz",
  "created_at": "2026-03-31T15:00:00Z"
}

Fleet Events

fleet.updated

Fired when a fleet item is updated (including status changes).

{
  "id": "evt_012",
  "type": "fleet.updated",
  "data": {
    "id": "fi_abc123",
    "name": "Trail Blazer 500",
    "changes": {
      "status": { "from": "available", "to": "maintenance" },
      "price_full_day": { "from": 5000, "to": 5500 }
    }
  },
  "tenant_id": "tenant_xyz",
  "created_at": "2026-03-31T16:00:00Z"
}

Waiver Events

waiver.signed

Fired when a waiver is signed.

{
  "id": "evt_013",
  "type": "waiver.signed",
  "data": {
    "waiver_id": "w_abc123",
    "booking_id": "bk_def456",
    "waiver_template_id": "wt_liability",
    "signer_name": "John Doe",
    "signer_email": "john@example.com",
    "pdf_url": "https://storage.getrenta.io/waivers/w_abc123.pdf",
    "signed_at": "2026-07-01T08:30:00Z"
  },
  "tenant_id": "tenant_xyz",
  "created_at": "2026-07-01T08:30:00Z"
}

Event Summary

Event	Trigger
`booking.created`	New booking created
`booking.confirmed`	Booking confirmed (payment received)
`booking.cancelled`	Booking cancelled
`booking.completed`	Rental returned, booking closed
`booking.extended`	Return date extended
`payment.received`	Payment successfully processed
`deposit.held`	Deposit authorization hold placed
`deposit.captured`	Deposit captured (full or partial)
`deposit.released`	Deposit released to customer
`customer.created`	New customer profile created
`customer.updated`	Customer info updated
`fleet.updated`	Fleet item updated
`waiver.signed`	Waiver signed

Subscribe to * (all events) or specific event types when creating a webhook endpoint. You can always update subscriptions later.

On this page