Webhooks & Integrations
Rentstuff can automatically notify external systems of events via webhooks. When something happens in the system, Rentstuff sends an HTTP POST request to your specified URL with the relevant data.
Quick Overview
Via Settings → Webhooks you register one or more webhook endpoints. Per endpoint you choose which event types are forwarded. On delivery failures, Rentstuff stores a delivery log and automatically disables an endpoint after 20 failed attempts.
Getting Started — Adding a Webhook
- Go to Settings → Webhooks.
- Tap + to add a new endpoint.
- Enter the URL of the external system (e.g. a Make.com webhook, a Zapier trigger or your own server).
- Optionally add a secret. This secret is sent as an
X-Webhook-Secretheader so you can verify the request genuinely comes from Rentstuff. - Select the event types this endpoint should receive.
- Tap Save.
The endpoint is immediately active.
Available Event Types
| Event | Trigger |
|---|---|
order.created | New order or quote created |
order.confirmed | Order confirmed (from Quote to Confirmed) |
order.status_changed | Any other order status change |
order.cancelled | Order cancelled |
quote.accepted_by_customer | Customer accepts a quote in the portal |
invoice.created | New invoice created |
invoice.paid | Invoice fully paid |
invoice.overdue | Invoice overdue (payment term expired) |
damage_report.opened | New damage report created |
damage_report.status_changed | Status change of a damage report |
stock_item.damaged | Damage report created for a stock item |
stock_item.status_changed | Status change of an individual stock item |
customer.created | New customer created |
payment.registered | Payment registered on an invoice |
Webhook Payload
Each webhook request has the following structure:
{
"event": "order.confirmed",
"company_id": "abc-123",
"occurred_at": "2026-04-15T14:23:00Z",
"data": {
"id": "order-uuid",
"order_number": "ORD-2026-0042",
"status": "confirmed",
"customer_name": "Example Ltd",
...
}
}
Rentstuff sends a Content-Type: application/json header and expects an HTTP 200 OK response within 10 seconds.
HMAC Signing
In addition to the optional secret, Rentstuff also offers HMAC signing for webhooks. Each webhook request includes the header:
X-Rentstuff-Signature: sha256=<hmac>
The HMAC is computed over the raw JSON body using the endpoint's secret (SHA-256). Verify the signature on your side to confirm the request is authentic and has not been tampered with:
import hmac, hashlib
def verify(payload_body: bytes, secret: str, signature_header: str) -> bool:
expected = "sha256=" + hmac.new(
secret.encode(), payload_body, hashlib.sha256
).hexdigest()
return hmac.compare_digest(expected, signature_header)
Only process webhook requests whose signature is valid. This prevents malicious parties from injecting fake events.
Delivery Log
Every webhook attempt is logged in the delivery log:
- Successful: HTTP 2xx received within the timeout
- Failed: connection error, timeout or HTTP 4xx/5xx response
The delivery log is visible via Settings → Webhooks → [endpoint] → Deliveries. Per attempt you see the date, HTTP status code and the full response body (useful for debugging).
After 20 consecutive failed deliveries the webhook endpoint is automatically disabled. You receive a notification in the app about this. Fix the cause of the errors and then manually re-enable the endpoint.
SSO Integrations
For SSO configuration (SAML or Office365/Azure AD) see Settings → SSO. Both protocols are supported and can be configured per company. SSO only applies to staff logins.
Setting Up SAML
- Go to Settings → SSO → SAML.
- Enter the IdP metadata: entity ID, SSO URL, the IdP certificate.
- Set the attribute mapping (how SAML attributes are translated to Rentstuff fields).
- Activate the SAML integration with the toggle.
- Share the SP metadata URL with your IdP:
https://api.rentstuff.io/auth/sso/saml/{company_slug}/metadata.
Setting Up Office365
- Go to Settings → SSO → Office365.
- Enter your Azure AD tenant ID, client ID and client secret.
- Set the allowed email domains.
- Activate the integration.
- Use the Test connection button to verify the credentials are correct.
With both SSO methods you can enable "Auto-create". New staff members who log in via SSO but don't yet have a Rentstuff account are then automatically created with the default role.