Heyy

communication 13 tools available

Connect with your customers on Whatsapp, SMS, Messenger and Instagram using automation.

About this integration

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

Connect Heyy to Definable and it becomes a set of typed tools your agents plan with — triggered by events, run on schedules, or invoked mid-conversation. Every write is checked by the verifier before it lands.

Auth OAuth2 · 2 clicks

Tools 13 exposed

Plans All, incl. Free

Data Never trained on

Heyy · in workflows

What teams actually run.

Three patterns teams run with Heyy on day one. Each one is a plain-English prompt — no canvas, no glue code — and you can remix them into anything.

Trigger on event

│ Listen for a new event

│ Parse and validate the payload

└ Take an action with the linked tool

Daily summary

│ Pull yesterday's activity

│ Summarise with the model of your choice

└ Send the digest via email or Slack

Cross-tool sync

│ Read records from one app

│ Transform with a persona

└ Write the result back via this integration

13 tools available

The Heyy toolbox.

Every Heyy capability your agents can call, each with a typed schema the planner reads. The router picks the right tool per step; the verifier checks the result.

Create Contact Attribute

Tool to create a new custom attribute for contacts in Heyy. Use when you need to add custom fields to track additional information about contacts, such as customer segments, preferences, or custom identifiers.

Create Contact

Tool to create a new contact in Heyy with optional details including first name, last name, email, phone number, labels, and custom attributes. Use when you need to add a new contact to your Heyy account.

Create Label

Tool to create a new label for categorizing contacts in Heyy. Use when you need to organize contacts into categories or groups.

Create Webhook

Tool to create a new webhook for receiving event notifications across multiple channels. Use when you need to set up real-time event notifications for messages.

Delete Attribute

Tool to delete an attribute by its unique identifier. Use when you need to remove an attribute from the system.

Delete Label

Tool to delete a label by its unique identifier. Use when you need to remove a label from the system.

Delete Webhook

Tool to delete a webhook by its unique identifier. Use when you need to remove a webhook from Heyy.

List Attributes

Tool to retrieve all attributes available in the Heyy system. Use when you need to get a list of all attributes with their properties and visibility settings.

List Automations

Tool to retrieve automation workflows for a specified channel. Use when you need to get all workflows configured for a channel.

List Channels

Tool to retrieve all available channels from the Heyy system. Use when you need to get a complete list of channels with their details including name, type, status, and timestamps.

List Message Templates

Tool to retrieve all message templates available in the Heyy system. Use when you need to view all existing templates for messaging.

List API Webhooks

Tool to retrieve all API webhooks configured for the account. Use when you need to inspect or manage webhook configurations.

Update Webhook

Tool to update a webhook's URL and active status. Use when you need to modify an existing webhook's endpoint or enable/disable it.

See it run

One prompt, start to finish.

A real prompt, the Heyy tools it calls, and what comes back. This is the whole interface — describe the outcome, agents handle the rest.

❯

Run a real Heyy task end-to-end — plan it, execute across the API, and hand back a verified result.

heyy.create_contact_attribute Tool to create a new custom attribute for contacts in Heyy. Use when you need to add custo

heyy.create_contact Tool to create a new contact in Heyy with optional details including first name, last name

heyy.create_label Tool to create a new label for categorizing contacts in Heyy. Use when you need to organiz · verified

done

Done. Heyy responded across 3 calls, the verifier signed off, and the result is logged with every payload.

FAQ · Heyy

Questions, answered.

What teams ask before connecting Heyy.

01 What can I automate with Heyy on Definable?

Anything Heyy exposes through its API. Common communication 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 13 Heyy tools directly, then chain the result into another integration without you writing code.

02 How does Heyy authentication work?

Heyy 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.

03 Is the Heyy integration included in my Definable plan?

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

04 Is using Heyy through Definable secure?

Every call from a persona to Heyy 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.

05 How do I get started with Heyy on Definable?

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

06 What Heyy actions does Definable expose?

Definable exposes all 13 Heyy actions as callable tools — including `Create Contact Attribute`, `Create Contact`, `Create Label`, plus 10 more. Each tool gets a typed parameter schema so personas know exactly how to call it.