← Tools Reference

Heyy

Heyy integration (Communication, Marketing). Imported from open-connector.

API key9 toolshttps://api.heyy.io/api/v2.0
GET
heyy_list_contacts
List Heyy contacts with optional pagination, sorting, and search.

/contacts

5 parameters
ParamTypeRequiredDescription
pageintegeroptionalThe Heyy contacts page number.
pageSizeintegeroptionalThe number of Heyy contacts to return.
sortBystringoptionalThe Heyy contact field to sort by.
orderstringoptionalThe Heyy contact sort order.
searchstringoptionalSearch text used to filter Heyy contacts.
GET
heyy_get_contact
Retrieve one Heyy contact by ID.

/contacts/{contactId}

1 parameter
ParamTypeRequiredDescription
contactIdstringrequiredThe Heyy contact ID.
POST
heyy_create_contact
Create a Heyy contact with profile fields, labels, and custom attributes.

/contacts

6 parameters
ParamTypeRequiredDescription
firstNamestringoptional
lastNamestringoptional
emailstringoptional
phoneNumberstringoptional
labelsarrayoptionalLabels to assign to the contact.
attributesarrayoptionalCustom attribute values to assign to the contact.
PUT
heyy_update_contact
Update a Heyy contact's profile fields, labels, or custom attributes.

/contacts/{contactId}

5 parameters
ParamTypeRequiredDescription
contactIdstringrequiredThe Heyy contact ID.
firstNamestringoptional
lastNamestringoptional
labelsarrayoptionalLabels to assign to the contact.
attributesarrayoptionalCustom attribute values to assign to the contact.
GET
heyy_list_labels
List Heyy labels.

/labels

POST
heyy_create_label
Create a Heyy label.

/labels

1 parameter
ParamTypeRequiredDescription
namestringrequiredThe Heyy label name.
GET
heyy_list_attributes
List Heyy contact attribute definitions.

/attributes

POST
heyy_create_attribute
Create a Heyy contact attribute definition.

/attributes

6 parameters
ParamTypeRequiredDescription
namestringrequiredThe Heyy attribute name.
externalIdstringrequiredThe Heyy attribute external ID.
descriptionstringoptional
isVisibleQuickEditbooleanoptionalWhether the attribute is visible in quick edit.
isVisibleContactsTablebooleanoptionalWhether the attribute is visible in the contacts table.
isVisibleContactCreatebooleanoptionalWhether the attribute is visible while creating contacts.
GET
heyy_list_channels
List Heyy communication channels.

/channels