# Headout AI integration on Definable

> Headout is a travel experiences and activities booking platform offering tours, attractions, and entertainment bookings worldwide.

## What this connects

Headout is a travel experiences and activities booking platform offering tours, attractions, and entertainment bookings worldwide.

Vendor: https://www.headout.com

## Tools available

**8** tools available. First 8:

- `HEADOUT_GET_PRODUCT_BY_ID` — Get Product By ID — Tool to retrieve detailed product information by product ID. Use when you need comprehensive product details including pricing, images, location, variants, and availability.
- `HEADOUT_LIST_CATEGORIES_V2` — List Categories V2 — Tool to fetch all available activity categories for a specific city using V2 API. Use when you need to list categories of activities available in a particular city location.
- `HEADOUT_LIST_CITIES` — List Cities — Tool to list all active cities with pagination support. Use when you need to retrieve available cities from the Headout platform. Supports pagination through offset and limit parameters.
- `HEADOUT_LIST_COLLECTIONS_V2` — List Collections V2 — Tool to fetch all collections for a specific city using V2 API with pagination support. Use when you need to browse collections available in a particular city, with optional language-specific content and pagination controls.
- `HEADOUT_LIST_INVENTORY_BY_VARIANT` — List Inventory by Variant — Tool to retrieve available inventory and pricing for a specific product variant. Use when you need to check availability and pricing details for booking.
- `HEADOUT_LIST_PRODUCTS_BY_CATEGORY` — List Products By Category — Tool to list product listings filtered by category ID with pagination support. Use when you need to retrieve products for a specific category.
- `HEADOUT_LIST_PRODUCTS_V2` — List Products V2 — Tool to fetch products using Headout V2 API with filtering by city, collection, category, or subcategory. Use when you need to retrieve product listings for specific locations or categories with pagination support.
- `HEADOUT_LIST_SUBCATEGORIES_V2` — List Subcategories V2 — Tool to fetch all subcategories for a specific city using V2 API. Use when you need to list subcategories of activities available in a particular city location.

## Auth

Auth schemes: `API_KEY`.

## How agents use Headout

Inside a Definable workflow, Headout is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Headout** — the Researcher (GPT-5.5) pulls context from Headout (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Headout** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Headout (create record, post message, draft email).
- **Designer / Engineer → Distributor → Headout** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Headout (attach file, open PR comment, post status).

The Verifier checks every Headout call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- scheduling & booking — https://definable.ai/apps/category/scheduling-&-booking/

## Related

- HTML page: https://definable.ai/apps/headout/
- Same category (scheduling & booking): https://definable.ai/apps/category/scheduling-&-booking/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt
