Integration · Marketing

Connect Claude & ChatGPT to Vibes

Ask your AI to find a subscriber by phone number, check which lists they are on, or schedule a broadcast in Vibes. It can add and update people, opt them into acquisition campaigns, send events to your triggered campaigns, and issue and redeem incentive codes. It can also read subscription lists, broadcasts and wallet campaigns.

Connect Vibes free

Free plan, no credit card. Takes about a minute.

Try asking

“Which subscription lists is +15551234567 on?”
The AI finds the person by mobile number, then lists the subscription lists they are active on.
“Opt this person out of the promotions list.”
It unsubscribes the person from that list. They stop receiving its messages.
“Schedule a broadcast to the VIP list for Friday at 10:00.”
It creates the broadcast with a name, send date and targeting. Real SMS or push messages go out at that time.

What your AI can do

People and subscriptions

Find people by phone number or external ID, add and update them, opt them into acquisition campaigns and out of lists.

Broadcasts and events

List, read, create, update and cancel broadcasts, read event-triggered campaigns and send the events that start them.

Incentives and wallet

List incentive pools, issue, check and redeem codes, and read Apple and Google Wallet campaigns.

“Move Friday's broadcast to Saturday, or cancel it.”
It updates the scheduled broadcast's send date, or cancels it so it is not sent.
“Issue a code from the summer offer pool to customer C-2291.”
It issues a code from the incentive pool to that external ID. It can later check the code's status or mark it redeemed.
“Send an order_shipped event for this customer.”
It sends the event to Vibes, and any matching event-triggered campaign messages the person.

75 tools for Vibes

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_campaign_participantChanges dataSign up a person to an acquisition campaign by `acquisition_id`, using a phone number, person ID or external ID. This can send them opt-in text messages.
attach_device_to_mobile_appChanges dataAssign a device (vibes device id). API summary: Associate device with person record.
create_broadcastChanges dataCreate a broadcast with a `name`, `targeting` (channel, lists, message template) and `send_schedule`. Once its send time arrives, messages go to every targeted subscriber.
create_bulkMoves moneyCreate a new bulk. Required: locations. Financial or irreversible action; may require approval. API summary: Bulk create store locations.
create_callbackChanges dataCreate a new callback. API summary: Register for a new callback type.
create_contactChanges dataCreate a mobile contact with a phone number (`mobile_phone.mdn`), optional `external_person_id` and custom fields.
create_messageChanges dataCreate a new message. Required: body. API summary: Create an event-triggered campaign.
create_poolChanges dataCreate a new pool. Required: name, issuance allowed, redemption allowed, incentive codes, distribution or notification email address. API summary: Create a new code pool.
create_testChanges dataCreate a new test. API summary: Create a test callback event.
create_walletChanges dataCreate a new wallet. Required: campaign. API summary: Create a wallet campaign.
create_wallet_location_selectorDeletesCreate a new location selector for a wallet. Required: location selector. Destructive action; may require approval. API summary: Create the location selector.
create_wallet_messageChanges dataCreate a new message for a wallet. Required: message. API summary: Create a wallet message.
create_wallet_passbook_templateDeletesCreate a new passbook template for a wallet. Required: passbook template. Destructive action; may require approval. API summary: Create the Apple Wallet template.
create_wallet_wallet_templateDeletesCreate a new wallet template for a wallet. Required: wallet template. Destructive action; may require approval. API summary: Create the Google Wallet template.
delete_addresses_allMoves moneyPermanently delete a address by token. Financial or irreversible action; may require approval. API summary: Delete all store locations.
delete_broadcastDeletesDelete a broadcast by `broadcast_id`, so a scheduled one is not sent. Cannot be undone.
delete_callbackDeletesPermanently delete a callback by callback id. Destructive action; may require approval. API summary: Cancel a callback.
delete_external_subscriptionDeletesPermanently delete a subscription by subscription list id. Destructive action; may require approval. API summary: Unsubscribe person by externalpersonid.
delete_messageDeletesPermanently delete a message by message id. Destructive action; may require approval. API summary: Cancel an event-triggered campaign.
delete_wallet_addressDeletesPermanently delete a address by address id. Destructive action; may require approval. API summary: Delete a store location.
delete_wallet_location_selectorsMoves moneyPermanently delete a location selector by token. Financial or irreversible action; may require approval. API summary: Delete the location selector.
find_contact_by_phoneFind a mobile contact by phone number (`mdn`).
get_acquisition_campaignGet one acquisition campaign by `acquisition_id`.
get_broadcastGet one broadcast by `broadcast_id`, with targeting and schedule.
get_callbackGet one callback by callback id. API summary: Get a callback.
get_contactGet one contact by `contact_key` (the Vibes person key), with phone and custom fields.
get_contact_by_external_idGet one contact by your own `external_person_id`.
get_contact_subscriptionGet one subscription for a contact by subscription list id. API summary: Get subscription status for list by personkey.
get_external_subscriptionGet one subscription for a external by subscription list id. API summary: Get subscription status for list by externalpersonid.
get_incentive_codeGet one incentive code and its status by `incentive_code`.
get_incentive_poolGet one incentive pool by `incentive_pool_id`.
get_mobile_app_deviceGet one device for a mobile app by vibes device id. API summary: Get push device info by vibesdeviceid.
get_subscription_listGet one subscription list by `subscription_id`.
get_triggered_messageGet one event-triggered message by `message_id`.
get_wallet_campaignGet one mobile wallet campaign by `wallet_id`.
get_wallet_messageGet one message for a wallet by wallet message id. API summary: Get a wallet message.
get_wallet_productGet one product for a wallet by wallet item id. API summary: Get a wallet item.
issue_incentive_codeChanges dataIssue a code from an incentive pool by `issuance_pool_id`, optionally to a specific person (`external_issuee_id`).
list_acquisition_campaignsList acquisition (sign-up) campaigns with their IDs.
list_acquisition_participantsList participants for a acquisition. Optional filters: mdn, person id or external person id. API summary: Search for pending participants.
list_broadcastsList message broadcasts, optionally filtered by `status`.
list_callbacksList callbacks. API summary: List registered callbacks.
list_code_issuancesList issuances for a code. API summary: Get issuances for a code.
list_code_redemptionsList redemptions for a code. API summary: Get redemptions for a code.
list_company_sourcecodesList sourcecodes for a company. API summary: Get your active source codes.
list_contact_push_devicesList push devices for a contact. API summary: Get push device info by personkey.
list_contact_subscriptionsList the subscription lists a contact (`person_key`) belongs to; `active_only` limits to active ones.
list_external_push_devicesList push devices for a external. API summary: Get push device info by externalpersonid.
list_external_subscriptionsList subscriptions for a external. API summary: Get subscriptions for externalpersonid.
list_incentive_poolsList incentive (coupon code) pools.
list_list_subscribersList or look up subscribers of a subscription list by `subscription_list_id`, optionally by phone (`mdn`), person key or external ID.
list_subscription_acquisition_campaignsList acquisition campaigns for a subscription. API summary: Get acquisition campaigns for subscription list.
list_subscription_listsList your subscription lists with their IDs.
list_triggered_messagesList event-triggered messages, filtered by `status` or `event_type`.
list_wallet_addressesList addresses for a wallet. Optional filters: zip, latitude or longitude. Results are paginated. API summary: Get store locations.
list_wallet_campaignsList mobile wallet campaigns.
list_wallet_itemsList passes (items) in a wallet campaign by `wallet_id`.
list_wallet_location_selectorsList location selectors for a wallet. API summary: Get the location selector.
list_wallet_messagesList messages for a wallet. API summary: Get wallet messages.
list_wallet_passbook_templatesList passbook templates for a wallet. API summary: Get the Apple Wallet template.
list_wallet_wallet_templatesList wallet templates for a wallet. API summary: Get the Google Wallet template.
redeem_incentive_codeChanges dataMark an incentive code as redeemed by `incentive_code`. Cannot be undone.
send_eventChanges dataSend an event of `event_type` for a person (`event_data` with phone, person ID or external ID). Event-triggered messages for that event are sent to them.
unsubscribe_contactDeletesUnsubscribe a contact (`person_key`) from a subscription list by `subscription_list_id`. They stop getting that list's messages.
update_broadcastVisible to othersUpdate a broadcast by `broadcast_id`: name, targeting or send schedule.
update_callbackChanges dataUpdate an existing callback identified by callback id. API summary: Update a callback.
update_contactChanges dataUpdate a contact by `contact_key`: phone number, external ID or custom fields.
update_externalChanges dataUpdate an existing external identified by external person id. API summary: Update person by externalpersonid.
update_messageVisible to othersUpdate an existing message identified by message id. Has effects visible outside this system. API summary: Update an event-triggered campaign.
update_poolChanges dataUpdate an existing pool identified by incentive pool id.
update_walletChanges dataUpdate an existing wallet identified by wallet id. API summary: Update a wallet campaign.
update_wallet_location_selectorsMoves moneyUpdate an existing location selector identified by token. Financial or irreversible action; may require approval. API summary: Update the location selector.
update_wallet_passbook_templatesMoves moneyUpdate an existing passbook template identified by token. Financial or irreversible action; may require approval. API summary: Update the Apple Wallet template.
update_wallet_productChanges dataUpdate an existing product identified by wallet item id. API summary: Update a wallet item.
update_wallet_wallet_templatesMoves moneyUpdate an existing wallet template identified by token. Financial or irreversible action; may require approval. API summary: Update the Google Wallet template.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Vibes from the app list.
2
Paste your key
Enter four values: your Vibes API address (US https://public-api.vibescm.com or EU https://public-api.eu.vibes.com), your Vibes Public API username and password, and your API Company Key. Your Vibes Mobile Engagement Services lead gives you the username and password. The Company Key is on the Account Profile page in the Vibes platform, labeled API Company Key.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Vibes?

It can find and read people and their subscriptions, and read subscription lists, broadcasts, acquisition and triggered campaigns, incentive pools and codes, and wallet campaigns. It can add and update people, opt them into acquisition campaigns or out of lists, create, update and cancel broadcasts, send events, and issue and redeem incentive codes.

Does the AI see my Vibes credentials?

No. Your Vibes username, password and Company Key are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Broadcasts, opt-ins and events can send real text or push messages, and redeeming an incentive code cannot be undone. Those tools can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Vibes account.

Where do I get the Vibes API username and password?

Your Vibes Mobile Engagement Services lead gives you the Public API username and password. US and EU accounts use different usernames and different API addresses, so pick the address that matches your account. The API Company Key is on your Account Profile page in Vibes.