Apaleo#

Apaleo is a cloud-based hotel property management system. This integration lets you manage properties, rooms (units), unit groups, and unit attributes through the Apaleo API via ClawLink's hosted OAuth flow -- no API keys to configure manually.

Setup in 3 Steps#

Step 1: InstallStep 2: Pair AccountStep 3: Connect Apaleo_App-specific connection GIF coming soon_Run the install command in OpenClawSign in and approve the deviceOpen the dashboard and connect Apaleo

How It Works#

text

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────>│   ClawLink   │────>│   Apaleo API     │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install#

bash

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start#

1. List all properties -- apaleo_get_a_properties_list
2. Get units for a property -- apaleo_get_a_units_list
3. Create a new unit -- apaleo_create_a_unit

Authentication#

ClawLink handles OAuth automatically. When you connect Apaleo through the dashboard, ClawLink obtains and refreshes tokens on your behalf. No API keys or manual token management required.

Connect at: https://claw-link.dev/dashboard?add=apaleo

Connection Management#

• List connections: clawlink_list_integrations
• Verify connection: clawlink_list_tools --integration apaleo
• Reconnect: Visit https://claw-link.dev/dashboard?add=apaleo

Security & Permissions#

Read operations (listing properties, units, attributes) require authorization but no specific scopes. Write and delete operations require scopes like properties.manage, units.create, or setup.manage. The agent will ask for confirmation before executing any write or delete action.

Tool Reference#

Property Operations#

ToolDescriptionModeapaleo_get_a_properties_listGet the list of propertiesReadapaleo_get_a_propertyGet a property by idReadapaleo_creates_a_propertyCreate a new propertyWriteapaleo_archive_a_propertyArchive an existing live propertyWriteapaleo_clones_a_propertyClone a specific property with inventory and rate plansWriteapaleo_move_property_to_liveMove an existing test property to liveWriteapaleo_reset_property_dataDelete transactional data for a test propertyWriteapaleo_check_if_a_property_existsCheck if a property exists by idReadapaleo_return_total_count_of_propertiesReturn total count of propertiesReadapaleo_returns_a_list_of_supported_countriesReturns ISO country codes for property creationRead

Unit Operations#

ToolDescriptionModeapaleo_get_a_units_listGet the list of unitsReadapaleo_get_a_unitGet a unit by idReadapaleo_create_a_unitCreate a new unitWriteapaleo_create_multiple_unitsCreate multiple units following a naming ruleWriteapaleo_delete_a_unitDelete a unitWriteapaleo_check_if_a_unit_existsCheck if a unit exists by idReadapaleo_returns_number_of_unitsReturns number of units matching filter criteriaRead

Unit Group Operations#

ToolDescriptionModeapaleo_list_unit_groupsGet the list of unit groupsReadapaleo_get_a_unit_groupGet a unit group by idReadapaleo_create_a_unit_groupCreate a new unit groupWriteapaleo_replace_a_unit_groupModify a unit groupWriteapaleo_delete_a_unit_groupDelete a unit groupWriteapaleo_check_if_a_unit_group_existsCheck if a unit group exists by idReadapaleo_returns_number_of_unit_groupsReturns number of unit groups matching filtersRead

Unit Attribute Operations#

ToolDescriptionModeapaleo_get_unit_attribute_listGet unit attribute listReadapaleo_get_unit_attribute_by_idGet unit attribute by idReadapaleo_create_a_unit_attributeCreate a new unit attributeWriteapaleo_deletes_unit_attributeDelete a unit attributeWriteapaleo_check_if_a_unit_attribute_existsCheck if a unit attribute existsRead

Code Examples#

List all properties

json

{
  "tool": "apaleo_get_a_properties_list",
  "args": {}
}

Get a specific unit

json

{
  "tool": "apaleo_get_a_unit",
  "args": { "unit_id": "U-001" }
}

Create a new unit

json

{
  "tool": "apaleo_create_a_unit",
  "args": {
    "property_id": "P-001",
    "name": "Room 101",
    "unit_group_id": "UG-001"
  }
}

Discovery Workflow#

1. Call clawlink_list_integrations to confirm apaleo is connected.
2. Call clawlink_list_tools --integration apaleo to see the live catalog.
3. Use apaleo_get_a_properties_list to find your property IDs.
4. Use unit and attribute tools to explore and manage inventory.

Execution Workflow#

text

Read path:  User asks "Show me all properties"  -> apaleo_get_a_properties_list
Write path: User asks "Create a new room"       -> Confirm -> apaleo_create_a_unit
Delete path: User asks "Remove unit X"          -> Confirm -> apaleo_delete_a_unit

Notes#

• Properties have two statuses: Test and Live. Only Test properties can have their data reset.
• Some operations (clone, archive, move to live) require properties.manage or setup.manage scopes.
• Unit deletion is permanent and cannot be undone.

Error Handling#

Status / ErrorMeaningTool not foundThe Apaleo integration is not connectedMissing connectionAuthenticate via https://claw-link.dev/dashboard?add=apaleo403 ForbiddenMissing required scope for the operation404 Not FoundProperty, unit, or unit group ID does not exist

Troubleshooting#

Tools Not Visible#

Run clawlink_list_tools --integration apaleo to confirm the connection is active and tools are loaded.

Invalid Tool Call#

Verify you are using the correct IDs (property_id, unit_id, unit_group_id). Use the list/read tools first to discover valid identifiers.

Resources#

• Apaleo API Docs: https://apaleo.com/api/
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=apaleo
• ClawLink Docs: https://docs.claw-link.dev/openclaw

---

Powered by ClawLink -- an integration hub for OpenClaw