n8n-nodes-starfish

This is an n8n community node. It lets you use the Starfish API (CampingCare/HotelCare) in your n8n workflows.

Starfish is a comprehensive booking and reservation management platform for camping and hotel accommodations, providing APIs for managing contacts, reservations, accommodations, invoices, rates, and more.

n8n is a fair-code licensed workflow automation platform.

• Installation
• Operations
• Credentials
• Compatibility
• Usage
• Development
• Resources
• Troubleshooting
• Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

This package provides two nodes:

Starfish (CampingCare/HotelCare) Node

Regular node for making API calls:

Accommodations API

• Get Accommodations - List accommodations with filtering options
• Get Accommodation - Retrieve a specific accommodation by ID
• Add Accommodation - Create a new accommodation
• Update Accommodation - Modify existing accommodation details
• Delete Accommodation - Remove an accommodation
• Places - Get places, get a single place, and update cleaning status (unknown, clean, wait_for_review, dirty)
• Meta Operations - Manage accommodation metadata (get, update, delete)

Administrations API

• Get Administrations - List all administrations
• Get Administration - Get details of a specific administration
• Add Administration - Create a new administration (full PMS or lite version)
• Update Administration - Modify administration details
• Delete Administration - Remove an administration
• Get Places - List places for a specific administration (filter, search, sort)
• Age Tables - Retrieve and manage age table configurations
• Meta Operations - Manage administration metadata

Availability API

• Get Stock - Check accommodation availability for specific date ranges
• Get Places - Get available places/spots

Categories API

• Get Categories - List all categories
• Get Category - Get a specific category by ID
• Add Category - Create a new category
• Update Category - Modify existing category
• Delete Category - Remove a category

Contacts API

• Get Contacts - List contacts with filtering and pagination
• Get Contact - Retrieve a specific contact by ID
• Add Contact - Create a new contact with metadata support
• Update Contact - Modify existing contact information
• Delete Contact - Remove a contact
• Meta Operations - Manage contact metadata

Exchange Rates API

• Get Exchange Rates - Get currency exchange rates for specific dates
• Exchange Value - Convert amounts between currencies

Invoices API

• Get Invoices - List invoices with filters
• Get Invoice - Get a specific invoice by ID
• Add Invoice - Create a new invoice
• Update Invoice - Modify existing invoice
• Delete Invoice - Remove an invoice
• Finalize Invoice - Finalize an invoice for payment
• Cancel Delayed Finalized Invoice - Cancel a delayed finalization
• Create Credit - Create a credit note for an invoice
• Add Rows - Add line items to an invoice
• Meta Operations - Manage invoice metadata

Kiosks API

• Get Kiosks - List all kiosks
• Get Kiosk - Get a specific kiosk by ID
• Add Kiosk - Create a new kiosk
• Update Kiosk - Modify kiosk details
• Delete Kiosk - Remove a kiosk
• Install Kiosk - Install a kiosk
• Meta Operations - Manage kiosk metadata

Ledgers API

• Get Ledgers - List all ledgers
• Get Ledger - Get a specific ledger by ID
• Add Ledger - Create a new ledger
• Update Ledger - Modify ledger details
• Delete Ledger - Remove a ledger

License Plates API

• Get License Plates - List license plates with filtering
• Get License Plate - Get a specific license plate by ID
• Check Valid License Plate - Validate a license plate
• Add License Plate - Create a new license plate entry
• Update License Plate - Modify existing license plate
• Delete License Plate - Remove a license plate

Logs API

• Get Logs - Retrieve log entries
• Add Log - Create a new log entry for tracking activities related to reservations, contacts, invoices, or accommodations

Price Calculation API

• Calculate Price - Get pricing information before creating a reservation with support for age tables, birthdates, discount codes, and channels

Products API

• Get Products - List all products with filtering options
• Get Product - Get a specific product by ID
• Add Product - Create a new product with multiple meta fields support
• Update Product - Modify existing product details including meta fields
• Delete Product - Remove a product
• Meta Operations - Manage product metadata (get, update, delete)

Rates API

• Get Rates - List all rates
• Get Rate - Get a specific rate by ID
• Add Rate - Create a new rate
• Update Rate - Modify existing rate
• Delete Rate - Remove a rate
• Get Prices - Retrieve prices for a specific rate and date range
• Update Prices - Modify rate prices for specific dates
• Meta Operations - Manage rate metadata

Reservations API

• Get Reservations - List all reservations with filtering
• Get Reservation - Get a specific reservation by ID
• Create Reservation - Create a new reservation (with price calculation or forced data)
• Delete Reservation - Remove a reservation
• Meta Operations - Manage reservation metadata

Tags API

• Get Tags - List all tags
• Get Tag - Get a specific tag by ID
• Add Tag - Create a new tag
• Delete Tag - Remove a tag

Timezones API

• Get Timezones - List all available timezones

Users API

• Get Users - List all users
• Get User - Get a specific user by ID
• Add User - Create a new user
• Update User - Modify user details
• Meta Operations - Manage user metadata

Widgets API

• Get Widgets - List all widgets
• Get Widget - Get a specific widget by ID
• Add Widget - Create a new widget
• Update Widget - Modify widget details
• Delete Widget - Remove a widget

Starfish (CampingCare/HotelCare) Trigger Node

Webhook trigger node for real-time events:

• Automatically creates and manages webhooks in Starfish
• Supports multiple event types (reservations, contacts, invoices, etc.)
• Receives real-time updates when data changes in Starfish
• Includes signature validation for security

Credentials

Setting up API Credentials

1. In n8n, go to Credentials > New
2. Search for "Starfish (CampingCare/HotelCare) API"
3. Enter your API credentials:
   • API Key: Your Starfish API key
   • Webhook Secret (optional): Value used to validate incoming webhooks; Starfish will echo it in the X-Webhook-Secret header and requests without it will be rejected.

Obtaining Your API Key

1. Log in to your Starfish dashboard (CampingCare or HotelCare)
2. Navigate to Settings > API Keys
3. Generate or copy your API key
4. Paste it into the n8n credentials field

The API key is used for authentication with all Starfish API endpoints. When provided, the webhook secret secures incoming webhooks.

Compatibility

• Minimum n8n version: 1.0.0
• Node.js version: >= 20.15
• Tested with: n8n 1.0.0+

This node uses the Starfish API v21. Ensure your API key has access to the required endpoints.

Usage

Getting Started

If you're new to n8n, check out the Try it out documentation to get started.

Example 1: Create a Contact

1. Add the "Starfish (CampingCare/HotelCare)" node
2. Select Resource: Contacts API
3. Select Operation: Add Contact
4. Fill in required fields:
   • Email (required)
   • First Name
   • Last Name
   • Phone, Address, etc. (optional)

The API allows creating contacts with minimal information and adding data as needed.

Example 2: Create a Reservation

1. Add the "Starfish (CampingCare/HotelCare)" node
2. Select Resource: Reservations API
3. Select Operation: Create Reservation
4. Choose creation method:
   • Using Price Calculation: First calculate price, then create reservation
   • Force with Own Data: Provide all required data directly

For the price calculation method:

1. First use Price Calculation API to get calculation_id and hash
2. Then create the reservation using these values

Example 3: Listen for Webhook Events

1. Add the "Starfish (CampingCare/HotelCare) Trigger" node
2. Select events to listen for (e.g., "reservation_create", "contact_update")
3. Activate the workflow
4. The webhook will be automatically registered with Starfish
5. When events occur, the workflow will be triggered

Important Notes

• Date Format: Always use YYYY-MM-DD format for dates.
• Required Fields: Some operations have required fields (marked with *)
• Meta Fields: Many resources support custom metadata via meta operations
• Pagination: Use count and limit parameters for large datasets
• Boolean Parameters: Use string values "0" or "1" for boolean query parameters (examples: get_meta, get_media, count)
• Field Mapping: When updating resources, only provided parameters will be updated
• Cleaning Status: Accommodation places cleaning uses the /cleaning path and statuses unknown|clean|wait_for_review|dirty

Development

• Install dependencies: pnpm install
• Build: pnpm run build (cleans dist, runs TypeScript, then gulp build:icons)
• Dev watch: pnpm run dev
• Lint: pnpm run lint (use pnpm run lintfix to auto-fix)
• Format: pnpm run format

Deploy to local n8n container (Windows)

• Run win_docker_deploy.bat from the repo root to build and copy the node into a Dockerized n8n instance. Ensure Docker Desktop is running and your container name matches what the script expects.

Webhook trigger validation

• The trigger node validates webhook signatures; configure events in the node, activate the workflow, and ensure the public URL is reachable by Starfish.

Resource coverage quick view

| Resource | Key operations | | --- | --- | | Accommodations | get, get by id, add/update/delete, meta, places, cleaning status | | Administrations | get, get by id, add/update/delete, meta, age tables, places | | Reservations | get, get by id, create, delete, meta | | Contacts | get, get by id, add/update/delete, meta | | Rates | get, get by id, add/update/delete, prices get/update, meta | | Invoices | get, get by id, add/update/delete, finalize/cancel, credit, rows, meta | | Products | get, get by id, add/update/delete, meta | | Others | Kiosks, Ledgers, License Plates, Exchange Rates, Logs, Categories, Tags, Users, Widgets, Timezones |

Resources

• Starfish API Documentation
• n8n Community Nodes Documentation
• GitHub Repository
• CampingCare Website
• HotelCare Website

Version History

Version 2.0.2 (Current)

• Added accommodations places coverage (get places, get place, update cleaning status via /cleaning)
• Fixed cleaning status endpoint path for accommodation places
• Existing coverage retained: Invoices, Rates (pricing and metadata), Kiosks, Ledgers, License Plates, Exchange Rates, Logs, Categories, Tags, Users, and meta operations across major resources
• Enhanced webhook trigger with signature validation and improved error handling

Version 1.0.6

• Broader API coverage across accommodations, reservations, contacts, and meta operations
• Enhanced README documentation

Version 1.0.0

• Initial release
• Support for Contacts, Reservations, and Accommodations
• Webhook trigger support
• Price calculation features
• Administrations and Timezones support

Troubleshooting

Common Issues

"Invalid API Key" error

• Verify your API key in the Starfish dashboard
• Check that the key hasn't expired
• Update the key in n8n credentials if necessary

Webhook not receiving events

• Ensure the workflow is activated
• Verify the webhook exists in your Starfish dashboard (Settings > Webhooks)
• Check that n8n is accessible from the internet (for webhooks to work)
• Review your firewall and network settings

Date format errors

• Ensure all dates use YYYY-MM-DD format
• Check your system timezone settings

Meta operations not working

• Verify the resource supports meta operations
• Check that the meta key is valid for the resource type
• Some meta operations may require specific permissions
• Ensure your API key has the necessary scopes

Rate limiting issues

• Implement delays between API calls if needed
• Check the API documentation for rate limits
• Consider batching operations where possible

Connection timeouts

• Check your internet connection
• Verify the Starfish API endpoint is accessible
• Try again after a few moments

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/my-feature
3. Commit your changes: git commit -am 'Add new feature'
4. Push to the branch: git push origin feature/my-feature
5. Submit a pull request

License

MIT

Support

For support:

• Check the API Documentation
• Open an issue on GitHub
• Contact Starfish support for API-related questions

Credits

Created by the CampingCare development team.

Built with the n8n nodes starter.