Headout

8 tools available

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

Connect Headout to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Headout's 8 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.

Common workflows with Headout

01

Trigger on event

  1. Listen for a new event
  2. Parse and validate the payload
  3. Take an action with the linked tool
02

Daily summary

  1. Pull yesterday's activity
  2. Summarise with the model of your choice
  3. Send the digest via email or Slack
03

Cross-tool sync

  1. Read records from one app
  2. Transform with a persona
  3. Write the result back via this integration

Headout actions 8

Every Headout action below is a callable tool any Definable persona can invoke.

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.

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.

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.

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.

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.

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.

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.

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.

Frequently asked questions

What can I automate with Headout on Definable?

Anything Headout exposes through its API. Common scheduling & booking workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 8 Headout tools directly, then chain the result into another integration without you writing code.

How does Headout authentication work?

Headout uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Headout integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 8 Headout tools. You only need a separate Headout subscription if Headout itself charges per seat or per API call.

Is using Headout through Definable secure?

Every call from a persona to Headout is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Headout on Definable?

Sign up for Definable, open the integrations page, find Headout, and connect via OAuth or API key. You can immediately attach Headout to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Headout actions does Definable expose?

Definable exposes all 8 Headout actions as callable tools — including `Get Product By ID`, `List Categories V2`, `List Cities`, plus 5 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Headout?

Wire it up in minutes. No coding required.

← All integrations