Why HubSpot can’t send iMessage on its own
HubSpot sends email and SMS (via integrations), but it cannot send iMessage — iMessage runs only through Apple’s network from a signed-in Apple ID. Tuco AI provides Apple-connected sending “lines,” so HubSpot becomes the system of record and Tuco becomes the iMessage sending layer.Method 1 — Connect HubSpot and send from a Tuco campaign (no code)
Best for bulk outreach and follow-up sequences.1
Connect HubSpot
In Tuco go to Integrations → CRM → Connect with HubSpot and authorize via OAuth (about 30 seconds). A full contact sync starts automatically; after that, Tuco pulls contacts modified in HubSpot every 15 minutes and deduplicates by phone number.
2
Check iMessage availability
Tuco automatically checks whether each synced contact can receive iMessage, so blue-bubble-eligible contacts are messaged over iMessage and the rest fall back to SMS. See Check iMessage availability.
3
Build and launch a campaign
Create a campaign with your message, personalization variables, and schedule. Use HubSpot properties (like
lifecyclestage) as live stop conditions and branches — every check calls the live HubSpot API, not stale cached data.Method 2 — Trigger an iMessage from a HubSpot workflow
Best for real-time, event-driven sends (e.g. “text me when a deal reaches Stage 2”). This uses HubSpot’s Send a webhook workflow action, available on HubSpot Operations Hub / Professional tiers. On plans without the webhook action, use a Custom Code action or Method 1 instead.- In your HubSpot workflow, add a Send a webhook action — method
POST, URLhttps://app.tuco.ai/api/messages. - Add header
Authorization: Bearer tuco_sk_xxxxxxxxxxxxx(your Tuco API key). - Send a JSON body with the contact’s
phone(oremail) and yourmessage. Optionally pin a sending line withlineIdor addattachmentUrls. Full field reference: Send Message API.
What syncs between HubSpot and Tuco
Owner mapping means messages are attributed to the right rep, and message activity can be logged back to the HubSpot contact timeline. See the full HubSpot integration reference.
Frequently asked questions
Does HubSpot have a native iMessage integration?
Does HubSpot have a native iMessage integration?
No. HubSpot cannot send iMessage on its own. Tuco AI is the bridge — it connects to HubSpot via OAuth and sends real iMessage texts from Apple-connected lines, with SMS fallback.
Do I need Operations Hub to send iMessage from a HubSpot workflow?
Do I need Operations Hub to send iMessage from a HubSpot workflow?
Only for Method 2 (the webhook-triggered send), which relies on HubSpot’s “Send a webhook” workflow action. Method 1 — syncing contacts and sending from a Tuco campaign — works on any HubSpot tier.
What happens if a contact isn't on iMessage?
What happens if a contact isn't on iMessage?
Tuco checks iMessage availability before sending and automatically routes non-iMessage contacts to your configured SMS fallback, so the message still lands. See failures and fallbacks.
Can I use HubSpot deal stages or properties to control sends?
Can I use HubSpot deal stages or properties to control sends?
Yes. HubSpot properties can be used as live stop conditions and branches in Tuco campaigns and Goal Bots — each check queries the live HubSpot API.
Connect HubSpot
Full HubSpot setup: sync, owner mapping, property mapping, and campaign conditions.