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: Install	Step 2: Pair Account	Step 3: Connect Apaleo
		App-specific connection GIF coming soon
Run the install command in OpenClaw	Sign in and approve the device	Open the dashboard and connect Apaleo

How It Works

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

Install

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

Unit Operations

Unit Group Operations

Unit Attribute Operations

Code Examples

List all properties

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

Get a specific unit

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

Create a new unit

{
  "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

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

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
• ClawLink Docs: https://docs.claw-link.dev/openclaw

Powered by ClawLink -- an integration hub for OpenClaw