Skip to main content

Connect Renterra to Zapier

Create an API key, point a Renterra webhook at Zapier, and understand the data Renterra sends — the one-time setup behind any Zapier automation.

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.

  1. Go to Settings > Data Integration and open the API tab.

  2. Click Add Key and give it a name that says where it's used, like Zapier.

  3. Copy the key immediately. It's only shown once, and it looks like rra_live_abc123_...

  4. 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.

  1. In Zapier, create a new Zap.

  2. For the trigger, choose Webhooks by Zapier, then the Catch Hook event.

  3. Zapier gives you a webhook URL that looks like https://hooks.zapier.com/hooks/catch/12345678/abcdefg/

  4. 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

  1. Go to Settings > Data Integration and open the Webhooks tab.

  2. Click Add Endpoint.

  3. Paste your Zapier Catch Hook URL into Endpoint URL.

  4. Add a Description so you can tell your endpoints apart later. Something like Zapier — new quotes to Zoho saves you guessing in six months.

  5. 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.

  6. Click Save.

These events are available today. Related events are grouped, so ticking order subscribes you to everything underneath it.

Event

Fires when

order.created

An order is created, including quotes

order.closed

An order is closed

invoice.created

An invoice is created

work_order.created

An internal work order or service request is created

work_order.closed

A work order is closed

customer.updated

Any field on a customer changes

contact.updated

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.

  1. In Renterra, open your endpoint from the Endpoints list and go to the Testing tab.

  2. Choose the event from the Send event dropdown.

  3. Click Send Example.

  4. In Zapier, go to the Test step of your Catch Hook and click Find new records. The example event appears in the list.

  5. 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 data to 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:

  1. Data is nested under data, which is why Zapier fields show up prefixed as "Data Order Status," etc.

  2. You get IDs, not names — that's why the "Reading Data Back" section exists later.

  3. 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 Quote

    • Data 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

GET

URL

https://api.getrenterra.com/v1/customers

Data Pass-Through?

false

Basic Auth

Leave empty

Headers

Authorization : Bearer rra_live_...

Return Raw Response

No

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

GET /v1/orders/{id}/billing-summary

A customer's name and revenue

GET /v1/customers?query={customer_id}

Create a customer

POST /v1/customers

Update a customer

PUT /v1/customers/{id}

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 401 from the API

Your API key is wrong, revoked, or in the wrong field. See Reading Data Back from Renterra

A 404 from the API

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


Looking for additional help? Get support directly from the Renterra team!
Chat with us directly or email us at [email protected].

Did this answer your question?