n8n-nodes-latepoint

This is an n8n community node that provides integration with the LatePoint appointment booking system using REST API.

LatePoint is a powerful WordPress plugin for appointment booking and scheduling. Documentation for complete API Reference information.

Installation

Community Nodes (Recommended)

For n8n cloud users and self-hosted instances with community nodes support:

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-latepoint
4. Agree to the risks of using community nodes
5. Select Install

Manual Installation

For self-hosted n8n instances:

npm install n8n-nodes-latepoint

Restart n8n and the node will be available in your node palette.

Prerequisites

• A WordPress site with LatePoint plugin installed
• LatePoint API Extension enabled
• Valid API credentials (Base URL and API Key)

Configuration

Credentials

Before using this node, you need to configure your LatePoint API credentials:

1. In n8n, go to Credentials and create new REST API for Latepoint credentials
2. Enter your REST API details:
   • Base URL: Your WordPress REST API URL (e.g., https://yoursite.com/wp-json/latepoint-api/v1)
   • API Key: Your API Key Credential

Getting API Credentials

1. Log into your WordPress admin panel
2. Navigate to LatePoint > API Settings > API Usage Information
3. Enable the API and generate your API key
4. Note your site's REST API base URL for LatePoint

Supported Operations

The node supports the following LatePoint resources and operations:

Bookings

• Get All: Retrieve all bookings
• Get: Retrieve a specific booking by ID
• Create: Create a new booking
• Bulk Create: Create multiple new bookings at once
• Update: Update an existing booking
• Delete: Delete a booking

Customers

• Get All: Retrieve all customers
• Get: Retrieve a specific customer by ID
• Create: Create a new customer
• Update: Update an existing customer
• Delete: Delete a customer

Agents

• Get All: Retrieve all agents
• Get: Retrieve a specific agent by ID

Services

• Get All: Retrieve all services
• Get: Retrieve a specific service by ID
• Update: Update an existing service
• Delete: Delete a service

Payments

• Get All: Retrieve all payments
• Get: Retrieve a specific payment by ID

Orders

• Get All: Retrieve all orders
• Get: Retrieve a specific order by ID
• Create: Create a new order
• Update: Update an existing order
• Delete: Delete an order

Coupons

• Get All: Retrieve all coupons
• Get by Code: Retrieve a specific coupon by code
• Create: Create a new coupon
• Update: Update an existing coupon
• Delete: Delete a coupon

Locations

• Get All: Retrieve all locations
• Get: Retrieve a specific location by ID

Availability

• Check Availability: Check availability for a service/agent on a specific date

System Info

• Get: Retrieve system information

Error Handling

The node provides detailed error messages for common issues:

• Authentication errors: Invalid API credentials
• Validation errors: Missing or invalid required fields
• Not found errors: Requested resource doesn't exist
• Server errors: LatePoint API server issues

Compatibility

• n8n version: 1.94.0 and above
• Node.js version: 16.x and above
• LatePoint version: 5.x.x and above
• LatePoint REST API Extension: Required

Support

For issues related to this n8n node:

• Contact on Discord: bizcoo
• Contact WPLimit support

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

Changelog

1.2.7

• Added: support for Latepoint 5.2.0.
• Enhanced: The email field is now optional instead of required.

1.2.6

• Added: New 'Check Availability' operation for Agents resource - allows checking agent availability by location, service, date, start time, and duration
• Enhanced: Agent availability filtering with configurable parameters (location_id, service_id, date, start_time, duration, limit)
• Improved: Integration with LatePoint's /agents/availability API endpoint for real-time availability checking
• Extended: Full n8n compatibility for agent availability workflows and automation

1.2.5

• Added: Now possible to view invoices linked to the order, allowing you to access the payment link directly.
• Enhanced: Validation that hooks execute correctly.
• Improved: The REST API now supports Latepoint V4.
• Extended: Fix bugs on AI Tools Booking Description.

1.2.4

• Added: Service Categories endpoint support - New 'Get Categories' operation for Services resource
• Enhanced: Service category retrieval with full pagination support (Return All/Limit options)
• Improved: API coverage for LatePoint service category management
• Extended: REST API integration to include GET /services/categories endpoint

1.2.3

• Fixed: TypeScript compilation error for icon property in credentials
• Added: LatePoint logo icon support for credentials UI
• Improved: TypeScript type safety for credential properties
• Enhanced: Visual appearance of credentials in n8n interface

1.2.2

• Advanced Booking Filters: Added comprehensive filtering system for GET /bookings endpoint
• Enhanced Query Parameters: Support for 20+ filter options including status, customer, agent, service, location, date ranges, payment status, price ranges, duration filters, and search functionality
• Smart Sorting: Added sort by multiple fields (ID, start date, created date, customer name, service name, status) with ascending/descending order
• Metadata Support: Added include_meta option and meta key/value filtering for custom booking data
• Date Range Filtering: Support for both booking date ranges (date_from/date_to) and creation date ranges (created_date_from/created_date_to)
• Customer Search: Filter by customer email, phone, or use general search across booking fields
• Payment Integration: Filter bookings by payment status (paid, not_paid, partially_paid)
• Price & Duration Filters: Set minimum and maximum price/duration ranges for booking queries
• Booking Code Search: Direct filtering by specific booking codes
• AI-Optimized: All filters designed for intelligent AI agent usage with contextual descriptions

1.2.0

• AI Agent Tools Support: Added usableAsTool: true property for n8n AI Agent compatibility
• Smart Parameter Completion: Implemented $fromAI() functionality for intelligent parameter auto-completion
• Optimized Descriptions: Simplified action descriptions for cleaner AI Agent tool display
• Enhanced Metadata: Added AI-optimized categorization and documentation links
• Improved UX: Streamlined subtitles and removed redundant text from tool names
• Better Integration: Full compatibility with n8n 1.82.0+ AI Agent Tools workflow

1.1.0

• Enhanced error handling and validation
• Improved credential management
• Updated dependencies and compatibility
• Bug fixes and performance improvements

1.0.0

• Initial release
• Support for all major LatePoint API endpoints
• Complete CRUD operations for customers, appointments, services, agents, locations
• Availability checking functionality
• Order and coupon management