Back to STR Integrations
Integration Guide

STR Integration Setup

Automatically send liability waivers to guests when a booking is created in your property management system.

What This Integration Does

The STR Integration automatically sends a liability waiver to guests when a booking is created in your property management system (PMS). Once connected, guests receive the waiver by email and you can see signing status in your Simple Waivers dashboard before check-in.

Works With Any Booking Platform

Any booking platform capable of sending webhooks or connecting to Zapier/Make can be used.

How It Works

Guest books a stay
Your PMS (Hostaway, Guesty, Lodgify, etc.)
Zapier or Make
Simple Waivers
Guest receives waiver email

Setup Overview

1

Generate an API key in Simple Waivers

2

Add your properties and map each one to a waiver

3

Set up a Zapier or Make automation for new bookings

4

Configure the webhook action to POST to Simple Waivers

1

Generate an API Key

In your Simple Waivers dashboard, go to STR Integrations → API Keys and click Generate new key.

Copy or save the key immediately. It is only shown once. Store it somewhere safe (e.g. a password manager or your Zapier/Make secret store).

The key format looks like:

sw_live_a1b2c3d4e5f6...
2

Add Your Properties

Each rental property must be added to Simple Waivers and linked to a waiver.

Go to STR Integrations → Properties and click Add Property.

FieldWhat to enter
Property NameHuman-readable name, e.g. "River House"
Property IDThe ID your PMS uses for this property
Assigned WaiverSelect the waiver guests will be asked to sign

The Property ID is what Simple Waivers uses to route each booking to the correct waiver. It must match exactly what your PMS sends in the webhook payload.

This ID can be numeric or text depending on your PMS. Simple Waivers treats it as a string and matches it exactly, so make sure it matches character-for-character with no extra spaces.

Finding your Property ID in Hostaway: Go to Listings → select the listing → the ID appears in the URL: hostaway.com/listings/12345 → Property ID is 12345.
Finding your Property ID in Guesty: Go to Properties → select the property → the ID appears in the URL or in the property details panel.
3

Configure Zapier

Trigger: New Booking in Hostaway

  1. In Zapier, create a new Zap
  2. Set the trigger app to Hostaway
  3. Select the event New Reservation (or Reservation Created)
  4. Connect your Hostaway account and test the trigger

Trigger: New Booking in Guesty

  1. In Zapier, create a new Zap
  2. Set the trigger app to Guesty
  3. Select the event New Reservation
  4. Connect your Guesty account and test the trigger

Alternative: Webhook → Zapier Catch Hook

If a native Zapier integration is unavailable:

  1. Add a Webhooks by Zapier step as the trigger
  2. Select Catch Hook
  3. Copy the webhook URL Zapier provides
  4. In your PMS, go to Settings → Webhooks and add the Zapier URL for the "reservation created" event

Action: POST to Simple Waivers

  1. Add a new action step
  2. Select Webhooks by Zapier → POST
  3. Set the URL to: 
    https://simplewaivers.com/api/integrations/booking-created
  4. Set Payload Type to JSON
  5. Add the following fields, mapping each to the corresponding value from your trigger step:
FieldZapier mapping
reservationIdReservation ID from your PMS
propertyIdListing/Property ID from your PMS
guestNameGuest full name
guestEmailGuest email address
checkInCheck-in date (YYYY-MM-DD)
checkOutCheck-out date (YYYY-MM-DD)

Under Headers, add:

Authorization: Bearer sw_live_YOUR_API_KEY_HERE
Content-Type: application/json

Test the step. You should see a 200 OK response with "success": true.

Rate limit: The endpoint supports up to 60 bookings per minute per host, which is sufficient for most rental operations.
4

Configure Make (formerly Integromat)

Trigger

  1. In Make, create a new scenario
  2. Add an HTTP → Custom Webhook module as the trigger
  3. Copy the webhook URL Make provides and add it to your PMS's webhook settings for "reservation created" events

Alternatively, use a native Make module for Hostaway or Guesty if available.

Action: POST to Simple Waivers

  1. Add an HTTP → Make a Request module
  2. Configure it:
    • URL: https://simplewaivers.com/api/integrations/booking-created
    • Method: POST
    • Headers: Authorization: Bearer sw_live_YOUR_API_KEY_HERE and Content-Type: application/json
    • Body type: Raw / Content type: application/json
  3. Map the request body fields from your trigger:
{
  "reservationId": "{{1.reservationId}}",
  "propertyId": "{{1.propertyId}}",
  "guestName": "{{1.guestName}}",
  "guestEmail": "{{1.guestEmail}}",
  "checkIn": "{{1.checkIn}}",
  "checkOut": "{{1.checkOut}}"
}

Run the scenario once with a test payload to verify the connection.

Test Your Setup

Once your Zapier or Make automation is configured:

  1. 1Trigger a test booking in your PMS (most platforms have a "test" or "sandbox" mode)
  2. 2Verify the webhook step returns "success": true in the Zapier/Make run log
  3. 3Confirm the reservation appears in STR Integrations → Reservations
  4. 4Check that the guest received the waiver email (use your own email for the test booking)

If any step fails, see the Troubleshooting and Error Reference sections below.

Example Webhook Request

This is the exact request Zapier or Make sends to Simple Waivers:

POST /api/integrations/booking-created HTTP/1.1
Host: simplewaivers.com
Authorization: Bearer sw_live_a1b2c3d4e5f6...
Content-Type: application/json

{
  "reservationId": "res_789",
  "propertyId": "prop_456",
  "guestName": "John Smith",
  "guestEmail": "john@example.com",
  "checkIn": "2026-05-10",
  "checkOut": "2026-05-13"
}

Success Response

{
  "success": true,
  "reservationId": "d4e5f6a1-...",
  "waiverLink": "https://simplewaivers.com/guest-waiver.html?code=XYZ123",
  "emailSent": true
}

Duplicate Booking (idempotent)

If the same reservationId is received again, Simple Waivers returns the existing record without re-sending the email:

{
  "success": true,
  "alreadyExists": true,
  "reservationId": "d4e5f6a1-...",
  "waiverLink": "https://simplewaivers.com/guest-waiver.html?code=XYZ123"
}

Guest Email

Once a booking is received, Simple Waivers automatically emails the guest with the subject "Please complete your liability waiver before arrival" and a "Sign Waiver" button linking to the waiver form. The guest can sign in under a minute on any device.

Error Reference

401 Invalid API key Check the key in your Zapier/Make action header
401 API key has been revoked Generate a new key in your dashboard
400 reservationId is required Map the field in your automation
400 propertyId is required Map the field in your automation
404 No property found with propertyId "..." Add the property in your dashboard; check the ID matches exactly
422 Property does not have a waiver assigned Assign a waiver to the property
422 Waiver is not active Reactivate the waiver in your dashboard

Security

Troubleshooting

Guest didn't receive the email

Check that guestEmail is being mapped correctly in your automation. The field is optional in the API but required for email delivery. Verify the email address in your PMS is accurate.

Waiver link in the response but no email sent

The emailSent: false field indicates the email failed. Check the guest email address is valid. You can copy the waiverLink from the response and send it manually as a fallback.

"No property found" error

The propertyId in your webhook payload must exactly match the Property ID you entered in Simple Waivers. Check for leading/trailing spaces or different ID formats (numeric vs. string).

Duplicate webhooks

Booking platforms sometimes resend events. Simple Waivers handles this automatically. If the same reservationId arrives twice, the second request returns alreadyExists: true and no duplicate email is sent.