ubtrippin

# UBTRIPPIN Skill

**UBTRIPPIN** is a personal travel tracker that parses booking confirmation emails and organises them into trips. It also handles event tickets — concerts, theater, sports, festivals — from providers like Ticketmaster, AXS, Eventbrite, and more. As an agent, you can read and manage a user's trips, items (flights, hotels, trains, tickets/events, etc.), loyalty vault, family groups, city guides, and more via REST API.

---

## Setup (First Time)

1. Ask your user to visit **ubtrippin.xyz/settings** and generate an API key.
2. The key looks like: `ubt_k1_<40 hex chars>`. Store it securely.
3. Ask for their **registered sender email** — the email address they use to forward bookings (typically their personal inbox). This is their "allowed sender" in UBTRIPPIN.
4. You'll need both to operate: the API key for reads/writes, the email address for adding new bookings via forwarding.
5. After setup, call `GET /api/v1/me/profile` and offer to set the user's home airport, currency preference, and seat preference via `PATCH /api/v1/me/profile`.

---

## Authentication

All API calls use a Bearer token:

```
Authorization: Bearer ubt_k1_<your_key>
```

Base URL: `https://www.ubtrippin.xyz`

**Rate limit:** 100 requests/minute per API key. HTTP 429 if exceeded — back off 60 seconds.

---

## API Endpoints

### Trips

#### List All Trips
```
GET /api/v1/trips
```

Query params: `?status=upcoming` (optional filter)

Response:
```json
{
  "data": [
    {
      "id": "uuid",
      "title": "Tokyo Spring 2026",
      "start_date": "2026-04-01",
      "end_date": "2026-04-14",
      "primary_location": "Tokyo, Japan",
      "travelers": ["Ian Rogers"],
      "notes": null,
      "cover_image_url": "https://...",
      "share_enabled": false,
      "created_at": "2026-02-15T10:00:00Z",
      "updated_at": "2026-02-15T10:00:00Z"
    }
  ],
  "meta": { "count": 1 }
}
```

Ordered by start_date descending (soonest upcoming / most recent first).

#### Get Trip with All Ite...

# UBTRIPPIN — OpenClaw Skill

Manage travel via UBTRIPPIN from any OpenClaw agent.

## Install

```bash
clawhub install ubtrippin
```

If you get a permission error, specify your workspace:

```bash
clawhub install ubtrippin --workdir ~/.openclaw/workspace
```

## Setup

1. Your user generates an API key at [ubtrippin.xyz/settings](https://www.ubtrippin.xyz/settings)
2. Store the key in your agent config or TOOLS.md
3. Start using the API — see SKILL.md for all endpoints and workflows

## API Docs

Live reference: [ubtrippin.xyz/api/v1/docs](https://www.ubtrippin.xyz/api/v1/docs)

## Links

- Website: [ubtrippin.xyz](https://www.ubtrippin.xyz)
- GitHub: [github.com/fistfulayen/ubtrippin](https://github.com/fistfulayen/ubtrippin)
- ClawHub: [clawhub.ai](https://clawhub.ai) → search "ubtrippin"