Skip to main content

Webhook Events

The platform emits 17 public webhook event types organised by category. Every row links to an auto-generated reference page with the envelope shape, data schema, sample payload, retry behaviour, and verification contract.

Source of truth: GET /api/v1/webhooks/events at https://valara.cloud/api/v1/webhooks/events (legacy alias: https://dash.jacoballenmedia.com/api/v1/webhooks/events).

Appointment Lifecycle

Event TypeDescriptionPage
appointment.cancelledAn appointment was cancelled.open
appointment.orphan.detectedA Tour calendar event could not be reconciled.open
appointment.rescheduledAn appointment was moved to a new time.open
appointment.scheduledA photo/video shoot appointment was scheduled.open

Billing

Event TypeDescriptionPage
invoice.payment_madeA Square invoice transitioned to PAID.open
subscription.cancelledAn agency cancelled their subscription.open
subscription.createdAn agency started a new platform subscription.open

Listing Lifecycle

Event TypeDescriptionPage
listing.cancelledA listing was cancelled.open
listing.createdA new listing was created via API or dashboard.open
listing.section_modifiedA listing section was updated.open
listing.status_changedA listing's status transitioned.open
listing.updatedListing metadata changed.open

Media

Event TypeDescriptionPage
media.delivery.completedComposio upload of listing media finished.open
media.delivery.failedComposio upload of listing media failed.open

User Lifecycle

Event TypeDescriptionPage
user.deactivatedA user was deactivated or soft-deleted.open
user.hierarchy_changedA user's managerId changed.open
user.signed_upA new Better Auth user was provisioned under an agency.open

Envelope primer

Every event carries the canonical envelope documented on the webhook overview page. Subscribe to a subset via the event_types array on POST /api/v1/webhooks/endpoints; omit the array to subscribe to every active type.

Events NOT listed here are part of the public deny list and are intentionally unavailable via the public subscription surface.