Register Webhook

Register a webhook endpoint to receive real-time notifications when events occur in your sandbox environment (e.g., RFP sent, bid received, booking confirmed).

Request Body

number

required

Your organization ID

string

required

The HTTPS URL where webhook events should be sent

array

required

Array of event types to subscribe to

string

Optional description for this webhook

string

Optional secret for webhook signature verification

Event Types

Subscribe to one or more of these event types:

draft_event.created - New draft event created
event.created - Draft converted to event
event.updated - Event details modified
rfp.sent - RFP sent to venue
bid.received - Venue submitted a bid
bid.accepted - Bid accepted by planner
bid.rejected - Bid rejected by planner
booking.created - New booking created
booking.updated - Booking modified
booking.cancelled - Booking cancelled
payment.received - Payment milestone completed

Response Format

{
  "webhook_id": 7001,
  "org_id": 123,
  "url": "https://your-app.com/webhooks/nowadays",
  "events": [
    "bid.received",
    "booking.created",
    "payment.received"
  ],
  "description": "Production integration webhook",
  "status": "active",
  "secret": "whsec_abc123...",
  "created_at": "2025-11-21T18:00:00Z"
}

Example Request

{
  "org_id": 123,
  "url": "https://your-app.com/webhooks/nowadays",
  "events": [
    "bid.received",
    "booking.created",
    "payment.received"
  ],
  "description": "Production integration webhook",
  "secret": "your_webhook_secret_key"
}

Webhook Payload Format

When an event occurs, a POST request will be sent to your URL:

{
  "webhook_id": 7001,
  "event_type": "bid.received",
  "event_id": 789,
  "data": {
    "bid_id": 1001,
    "venue_name": "Austin Convention Center Hotel",
    "total_cost": 125000,
    "created_at": "2025-11-21T19:00:00Z"
  },
  "timestamp": "2025-11-21T19:00:01Z",
  "signature": "sha256=..."
}

Notes

Webhook URLs must use HTTPS
Failed deliveries are retried up to 3 times with exponential backoff
Use the secret to verify webhook authenticity via HMAC signature
Webhooks timeout after 10 seconds
Return a 2xx status code to acknowledge receipt

Events

Venues

Event Agencies

Batch Operations

Sandbox APIs

Request Body

Event Types

Response Format

Example Request

Webhook Payload Format

Notes

​Request Body

​Event Types

​Response Format

​Example Request

​Webhook Payload Format

​Notes

Request Body

Event Types

Response Format

Example Request

Webhook Payload Format

Notes