Overview
Zapier lets you connect Renterra to thousands of other apps without writing any code. This article covers the one-time setup: creating an API key, pointing a Renterra webhook at Zapier, and understanding the data Renterra sends. Once this is done, you can build automations for any app Zapier supports.
Renterra doesn't have its own Zapier app yet, so you'll use Zapier's built-in Webhooks by Zapier to talk to us. That means two things:
Webhooks by Zapier receives events from Renterra and sends requests to our API.
Everything else in your Zap — Zoho CRM, Slack, Google Sheets — works exactly as it normally would.
Before you start. Webhooks by Zapier is marked Premium in Zapier, so you'll need a paid Zapier plan (or an active free trial of one). Many popular destination apps carry the same badge.
That purple Premium badge is Zapier's label, not the other app's. It means Zapier restricts that connector to paid Zapier plans. It does not mean you need to upgrade your plan with the destination app.
What You'll Need
Requirement | Where it comes from |
The Manage Data Integration permission | Your Renterra admin |
A Renterra API key | Settings > Data Integration > API |
A paid Zapier plan | Zapier |
API keys and webhooks aren't available in Sandbox accounts, so you'll need to set this up in your live account.
Step 1: Create a Renterra API Key
Your API key lets Zapier read data out of Renterra — customer names, order totals, and anything else your automation needs.
Go to Settings > Data Integration and open the API tab.
Click Add Key and give it a name that says where it's used, like Zapier.
Copy the key immediately. It's only shown once, and it looks like
rra_live_abc123_...Store it somewhere safe, like a password manager.
Treat your API key like a password. If it's ever exposed, revoke it from the same screen and create a new one.
Step 2: Create a Catch Hook in Zapier
Before Renterra can send you events, you need somewhere to send them.
In Zapier, create a new Zap.
For the trigger, choose Webhooks by Zapier, then the Catch Hook event.
Zapier gives you a webhook URL that looks like
https://hooks.zapier.com/hooks/catch/12345678/abcdefg/Copy it. You'll paste it into Renterra next.
Keep this URL private. Anyone who has it can send data into your Zap.
Step 3: Point Renterra at Your Catch Hook
Go to Settings > Data Integration and open the Webhooks tab.
Click Add Endpoint.
Paste your Zapier Catch Hook URL into Endpoint URL.
Add a Description so you can tell your endpoints apart later. Something like Zapier — new quotes to Zoho saves you guessing in six months.
Under Subscribe to events, tick the events this endpoint should receive. Hover any event for a one-line explanation, or open the Event Catalog tab for the full detail.
Click Save.
These events are available today. Related events are grouped, so ticking order subscribes you to everything underneath it.
Event | Fires when |
| An order is created, including quotes |
| An order is closed |
| An invoice is created |
| An internal work order or service request is created |
| A work order is closed |
| Any field on a customer changes |
| Any field on a contact changes |
Tick at least one event. If you leave the list empty, the endpoint shows Receiving all events and every event type gets sent to your Zap. That's rarely what you want.
One Endpoint Per Zap
Each endpoint sends to a single URL, and each Zap has a single Catch Hook URL. So one endpoint feeds one Zap.
That means you'll usually want a separate endpoint for each Zap you build, subscribed only to the events that Zap should react to. Two Zaps that do different jobs — one that creates a record, one that closes it — need two endpoints.
Putting several events on one endpoint sends them all into the same Zap, which then has to work out which event it received and branch accordingly. That needs a Paths by Zapier step, and Paths is only available on higher Zapier plans. Separate endpoints avoid the problem entirely, and they're easier to troubleshoot because Message Attempts is listed per endpoint.
Do subscribe one endpoint to many events when a single Zap treats them all the same way — posting every Renterra event into a Slack channel, for example, or forwarding everything to a reporting tool.
Step 4: Send a Test Event
Zapier needs to see an event before it can map the fields, and Renterra can send it a sample one. You don't have to create a real record just to test.
In Renterra, open your endpoint from the Endpoints list and go to the Testing tab.
Choose the event from the Send event dropdown.
Click Send Example.
In Zapier, go to the Test step of your Catch Hook and click Find new records. The example event appears in the list.
Select it and click Continue with selected record.
Two things to know about example events. They carry placeholder data, so the IDs won't match anything in your account — a Zap step that looks a record up by ID will come back empty. And a failed example delivery isn't retried, unlike a real one.
Once your Zap is built, fire a real record through it — save an actual quote, or close an actual order — before you turn it on. That confirms the whole chain works with your own data.
Checking a Delivery
Click your endpoint in the Endpoints list to open its detail view. The Overview tab shows:
Subscribed events — confirm you ticked the right ones
Delivery Stats (last 24h) — a quick health check
Message Attempts — every delivery, filterable by Succeeded, Failed, or Canceled
Signing Secret — click the eye icon to reveal it, and rotate it here if it's ever exposed
If a delivery failed, fix the problem and use the Replay button to send it again. You don't have to recreate the record in Renterra just to retest.
The Event Catalog
Before you build anything, open the Event Catalog tab. For each event it gives you two views side by side:
A field browser — every field, its type, and its format. Expand
datato see the nested record and exactly which fields it contains.An Example — a complete sample payload you can copy.
This is the reference to work from. An order.created payload, for instance, carries exactly ten fields on the order record — and knowing that up front tells you what you'll need to fetch from the API instead.
Payload Shape
Three things to know:
Data is nested under
data, which is why Zapier fields show up prefixed as "Data Order Status," etc.You get IDs, not names — that's why the "Reading Data Back" section exists later.
Update events carry
previous_attributes, useful for filtering on what changed.
Filter Before You Act
Most Renterra events fire more often than you want your Zap to run. order.created fires for every quote, reservation, and rental, not just the one you care about.
Add a Filter by Zapier step right after your Catch Hook and set a condition on a field from the payload.
For example, to act only on Storefront quotes:
Only continue if:
Data Order Status (Text) Exactly matches
QuoteData Source (Text) Exactly matches
Storefront
This keeps your Zap task usage down and stops unwanted records from reaching the destination app.
Reading Data Back from Renterra
When you need more than the webhook gives you, add a Webhooks by Zapier > Custom Request step to call the Renterra API.
Configure the step like this:
Field | Value |
Method |
|
URL |
|
Data Pass-Through? |
|
Basic Auth | Leave empty |
Headers |
|
Return Raw Response |
|
Don't use the Basic Auth field. It looks like the right place, but Renterra uses a bearer token, not basic auth. Putting your key there returns a 401 with nothing explaining why. The key goes in Headers, and the value must start with the word Bearer followed by a space.
Leave Data Pass-Through set to false. Set to true, Zapier appends the whole webhook payload to your request and the call breaks.
Some endpoints you'll use often:
What you want | Endpoint |
An order's billed total |
|
A customer's name and revenue |
|
Create a customer |
|
Update a customer |
|
Most of the API is read-only. Customers can be created and updated, and contacts can be updated. Branches, vendors, inventory, orders, invoices, payments, work orders, and accounting data can be listed but not changed.
The full endpoint list, including every field and filter, lives in our API Documentation.
Verifying Webhook Signatures
Every webhook Renterra sends is signed, but since a Zapier Catch Hook URL is already hard to guess, most automations don't need to verify it — if yours does, add a Code by Zapier step to check the signature before continuing.
Troubleshooting
Problem | What to check |
No events reach Zapier | Open your endpoint and check Message Attempts. If it says This endpoint has not received any messages yet, check Subscribed events — you may not have ticked the event you expected. |
Deliveries show as Failed | Zapier received the event but returned an error. Open the Zap history in Zapier to see which step failed, then use Replay on the endpoint to retry. |
A | Your API key is wrong, revoked, or in the wrong field. See Reading Data Back from Renterra |
A | Check the record ID. Sandbox IDs don't exist in your live account, and example-event IDs aren't real records. |
The Zap runs too often | Add a Filter by Zapier step. See Filter Before You Act above. |
You can't find the API tab | You need the Manage Data Integration permission. Ask your Renterra admin. |
Explore More
Send Renterra Quotes and Orders to Zoho CRM — a complete Zapier automation built on this setup
Renterra's Open API and Webhooks — an overview of what the API and webhooks can do
Looking for additional help? Get support directly from the Renterra team!
Chat with us directly or email us at [email protected].







