rv-rental-api

n8n node for RV Rental Management System API with AI Agent tool support

Package Information

Released: 7/29/2025

Downloads: 21 weekly / 47 monthly

Latest Version: 1.8.0

Author: Your Name

Available Nodes

RV Rental API

No description available

RV Rental Webhook

No description available

Documentation

n8n-nodes-rv-rental-api

This is an n8n community node for the RV Rental Management System API. It provides easy access to reservation data and management features directly within your n8n workflows. Optimized for AI agents and intelligent automation workflows.

Features

Get All Reservations: Retrieve reservations with optional filtering by status, source, date range, and limit
Get Reservation by ID: Fetch detailed information for a specific reservation
Search Reservations: AI-optimized search with natural language support
Update Reservation Status: Change reservation status with audit trail
Store SignWell Agreement Link: Store SignWell rental agreement links for reservations
Get All Customers: Retrieve customer data with filtering options
Get Customer by ID: Fetch detailed customer information
Stripe Integration: Access Stripe customer and payment method data
Built-in Authentication: Secure API token authentication
AI-Friendly Error Handling: Enhanced error messages with context for AI agents
Type Safety: Full TypeScript support with proper typing

🤖 AI Agent Integration

This node is specifically designed to work seamlessly with n8n's AI Agent node and other AI workflow tools. It provides:

AI-Optimized Features

Natural Language Search: Use the "Search Reservations" operation with queries like "John's booking next week" or "cancelled reservations this month"
Contextual Error Messages: AI-friendly error descriptions that help agents provide better customer service
Intelligent Filtering: Smart filtering options that work well with AI-generated queries
Business Context: Operation descriptions include business purpose and use cases

Common AI Use Cases

Customer Service Chatbot: Answer booking questions, check reservation status, provide rental details
Booking Assistant: Help customers find available RVs, check dates, assist with reservations
Payment Support: Handle billing inquiries, payment method questions, financial assistance
Document Management: Automate rental agreement signing, track document status
Business Intelligence: Generate reports, analyze booking trends, provide insights

AI Workflow Examples

Check out the examples/ai-workflows.json file for complete AI workflow examples including:

Customer service automation
Booking availability assistance
Payment support workflows
Rental agreement management
Business intelligence reporting

Email Templates

Professional email templates are included for common workflows:

templates/booking-confirmation-onboarding.html - Customer onboarding and booking confirmation email template

🛠️ AI Agent Tool Integration

NEW! Use the RV Rental API node as intelligent tools for AI Agents through sub-workflows:

Quick Setup

Import example workflows from examples/ai-agent-tool-workflows.json
Configure AI Agent with the provided tool definitions
Start using natural language commands like:
- "What reservations are pending approval?"
- "Approve reservation 14 and send the onboarding email"
- "Show me available dates for listing 1 next month"
- "Decline reservation 3 and notify the customer"

Available AI Tools

get_pending_reservations - Get all pending reservations needing approval
approve_reservation - Approve reservations with automatic email notifications
decline_reservation - Decline reservations with customer notifications
search_reservations - Search by customer, dates, status, or reference
get_availability_calendar - Generate availability for social media posts

📖 Complete AI Agent Setup Guide

Example Tool Configuration

{
  "name": "get_pending_reservations",
  "description": "Get all pending reservations that need approval",
  "url": "http://localhost:5678/webhook/ai-tools/pending-reservations",
  "method": "POST",
  "parameters": {
    "type": "object",
    "properties": {
      "limit": {
        "type": "number",
        "description": "Maximum number of reservations to return"
      }
    }
  }
}

Installation

Community Nodes (Recommended)

Go to Settings > Community Nodes in your n8n instance
Click Install a community node
Enter n8n-nodes-rv-rental-api
Click Install

Manual Installation

Navigate to your n8n installation directory
Run: npm install n8n-nodes-rv-rental-api
Restart n8n

Self-Hosted Installation

Clone this repository
Run npm run build
Copy the dist folder to your n8n custom nodes directory
Restart n8n

Configuration

1. Generate API Token

First, generate an API token for an admin user in your RV Rental system:

# Using Laravel Artisan
php artisan api:generate-token admin@bestillrvrentals.com

# Using Laravel Sail
./vendor/bin/sail artisan api:generate-token admin@bestillrvrentals.com

2. Set Up Credentials

In n8n, go to Credentials
Click Create New Credential
Search for "RV Rental API"
Fill in:
- Base URL: Your RV Rental system URL (e.g., https://bestillrvrentals.com)
- API Token: The token generated in step 1

3. Test Connection

Click Test to verify your credentials work correctly.

Usage

Get All Reservations

Use this operation to retrieve reservations with optional filtering:

Available Filters:

Status: pending, confirmed, blocked, cancelled
Source: direct, rv_share, outdoorsy, manual
Start Date: Filter reservations starting from this date
End Date: Filter reservations ending before this date
Limit: Maximum results (1-500, default: 100)

Example Output:

{
  "id": 14,
  "reference_number": "BRV-000014",
  "listing_name": "2025 Jayco Jayflight SLX 260BH",
  "start_date": "2025-08-01",
  "end_date": "2025-08-05",
  "nights": 4,
  "status": "pending",
  "customer_email": "customer@example.com",
  "total_amount": "850.00"
}

Get Reservation by ID

Retrieve detailed information for a specific reservation:

Input:

Reservation ID: The numeric ID of the reservation