How do I install the Smoobu skill?

Run npx skillmds@latest add dvcrn/smoobu in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Smoobu safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Smoobu?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Smoobu free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Smoobu?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Smoobu by dvcrn — Agent Skill

Name: Smoobu
Rating: 4.2 (5 reviews)
Author: dvcrn

Smoobu

Interact with Smoobu property management API. Use for checking bookings, availability, managing reservations, and listing apartments/properties. Triggers on rental property management, Airbnb sync, vacation rental bookings, guest management.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

Smoobu Property Management

Smoobu is a channel manager for vacation rentals (Airbnb, Booking.com, etc).

Setup

Requires SMOOBU_API_KEY in ~/.openclaw/.env:

SMOOBU_API_KEY=your_api_key_here

Find your API key in Smoobu: Settings → Developers

Quick Reference

API Base

https://login.smoobu.com

Authentication

Header: Api-Key: {SMOOBU_API_KEY}

Rate Limit

1000 requests/minute

Common Operations

List Properties

curl -s "https://login.smoobu.com/api/apartments" \
  -H "Api-Key: $SMOOBU_API_KEY" | jq

Get Bookings

# All bookings
curl -s "https://login.smoobu.com/api/reservations" \
  -H "Api-Key: $SMOOBU_API_KEY" | jq

# Filter by dates
curl -s "https://login.smoobu.com/api/reservations?from=2026-02-01&to=2026-02-28" \
  -H "Api-Key: $SMOOBU_API_KEY" | jq

# Filter by apartment
curl -s "https://login.smoobu.com/api/reservations?apartmentId=123" \
  -H "Api-Key: $SMOOBU_API_KEY" | jq

Check Availability

curl -s -X POST "https://login.smoobu.com/booking/checkApartmentAvailability" \
  -H "Api-Key: $SMOOBU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "arrivalDate": "2026-03-01",
    "departureDate": "2026-03-05",
    "apartments": [123, 456]
  }' | jq

Create Booking

curl -s -X POST "https://login.smoobu.com/api/reservations" \
  -H "Api-Key: $SMOOBU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "arrivalDate": "2026-03-01",
    "departureDate": "2026-03-05",
    "apartmentId": 123,
    "channelId": 70,
    "firstName": "John",
    "lastName": "Doe",
    "email": "john@example.com",
    "adults": 2
  }' | jq

Update Booking

curl -s -X PUT "https://login.smoobu.com/api/reservations/{id}" \
  -H "Api-Key: $SMOOBU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "arrivalTime": "15:00",
    "departureTime": "11:00",
    "notice": "Late checkout requested"
  }' | jq

Get User Profile

curl -s "https://login.smoobu.com/api/me" \
  -H "Api-Key: $SMOOBU_API_KEY" | jq

Helper Script

Use scripts/smoobu.py for common operations:

# List apartments
python3 scripts/smoobu.py apartments

# List bookings (optional date range)
python3 scripts/smoobu.py bookings
python3 scripts/smoobu.py bookings --from 2026-02-01 --to 2026-02-28

# Check availability
python3 scripts/smoobu.py availability --arrival 2026-03-01 --departure 2026-03-05

# Get user info
python3 scripts/smoobu.py me

API Response Examples

Booking Object

{
  "id": 291,
  "type": "reservation",
  "arrival": "2026-02-10",
  "departure": "2026-02-12",
  "apartment": {"id": 123, "name": "Beach House"},
  "channel": {"id": 465614, "name": "Booking.com"},
  "guest-name": "John Doe",
  "price": 250.00,
  "adults": 2,
  "children": 0
}

Apartment Object

{
  "id": 123,
  "name": "Beach House",
  "location": {"city": "Nice", "country": "France"}
}

Error Handling

Status	Meaning
401	Invalid API key
400	Validation error (check response body)
429	Rate limit exceeded

Docs

Full API: https://docs.smoobu.com

---name: smoobudescription: Interact with Smoobu property management API. Use for checking bookings, availability, managing reservations, and listing apartments/properties. Triggers on rental property management, Airbnb sync, vacation rental bookings, guest management.---# Smoobu Property ManagementSmoobu is a channel manager for vacation rentals (Airbnb, Booking.com, etc).## SetupRequires `SMOOBU_API_KEY` in `~/.openclaw/.env`:```SMOOBU_API_KEY=your_api_key_here```Find your API key in Smoobu: Settings → Developers## Quick Reference### API Base`https://login.smoobu.com`### AuthenticationHeader: `Api-Key: {SMOOBU_API_KEY}`### Rate Limit1000 requests/minute## Common Operations### List Properties```bashcurl -s "https://login.smoobu.com/api/apartments" \ -H "Api-Key: $SMOOBU_API_KEY" | jq```### Get Bookings```bash# All bookingscurl -s "https://login.smoobu.com/api/reservations" \ -H "Api-Key: $SMOOBU_API_KEY" | jq# Filter by datescurl -s "https://login.smoobu.com/api/reservations?from=2026-02-01&to=2026-02-28" \ -H "Api-Key: $SMOOBU_API_KEY" | jq# Filter by apartmentcurl -s "https://login.smoobu.com/api/reservations?apartmentId=123" \ -H "Api-Key: $SMOOBU_API_KEY" | jq```### Check Availability```bashcurl -s -X POST "https://login.smoobu.com/booking/checkApartmentAvailability" \ -H "Api-Key: $SMOOBU_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "arrivalDate": "2026-03-01", "departureDate": "2026-03-05", "apartments": [123, 456] }' | jq```### Create Booking```bashcurl -s -X POST "https://login.smoobu.com/api/reservations" \ -H "Api-Key: $SMOOBU_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "arrivalDate": "2026-03-01", "departureDate": "2026-03-05", "apartmentId": 123, "channelId": 70, "firstName": "John", "lastName": "Doe", "email": "john@example.com", "adults": 2 }' | jq```### Update Booking```bashcurl -s -X PUT "https://login.smoobu.com/api/reservations/{id}" \ -H "Api-Key: $SMOOBU_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "arrivalTime": "15:00", "departureTime": "11:00", "notice": "Late checkout requested" }' | jq```### Get User Profile```bashcurl -s "https://login.smoobu.com/api/me" \ -H "Api-Key: $SMOOBU_API_KEY" | jq```## Helper ScriptUse `scripts/smoobu.py` for common operations:```bash# List apartmentspython3 scripts/smoobu.py apartments# List bookings (optional date range)python3 scripts/smoobu.py bookingspython3 scripts/smoobu.py bookings --from 2026-02-01 --to 2026-02-28# Check availabilitypython3 scripts/smoobu.py availability --arrival 2026-03-01 --departure 2026-03-05# Get user infopython3 scripts/smoobu.py me```## API Response Examples### Booking Object```json{ "id": 291, "type": "reservation", "arrival": "2026-02-10", "departure": "2026-02-12", "apartment": {"id": 123, "name": "Beach House"}, "channel": {"id": 465614, "name": "Booking.com"}, "guest-name": "John Doe", "price": 250.00, "adults": 2, "children": 0}```### Apartment Object```json{ "id": 123, "name": "Beach House", "location": {"city": "Nice", "country": "France"}}```## Error Handling| Status | Meaning ||--------|---------|| 401 | Invalid API key || 400 | Validation error (check response body) || 429 | Rate limit exceeded |## DocsFull API: https://docs.smoobu.com

Frequently asked questions