topic Send a WhatsApp template using API. in APIs & Integrations

Send a WhatsApp template using API.

VMartins5 — Wed, 20 Aug 2025 17:55:09 GMT

I'm trying to send WhatsApp messages with quick replies via API (Meta and WhatsApp Business are already connected), but I can't find any instructions in the documentation.

Using this endpoint:

POST /conversations/v3/conversations/threads/{threadId}/messages

The documentation doesn't explain how to include quick replies. I assumed the only way to do this is via pre-approved WhatsApp templates, but I don't see how to achieve it. I noticed the WHATSAPP_TEMPLATE_METADATA option under attachments, but I cannot find any explanation about how to use it.

Is there a documented way to send messages with quick replies?

Re: Send a WhatsApp template using API.

STierney — Thu, 21 Aug 2025 01:16:00 GMT

Hey @VMartins5 - thanks for posting in the Community!

I've been reading through our documentation on the messages API currently in beta, which mentions quick replies. Is this the documentation you were referencing in your post? As this is a little beyond my knowledge base, I'd like to tag in some API experts to see what may be happening here!

@dsmarion, @Gonzalo, and @nickdeckerdevs1 - any thoughts on how @VMartins5 may be able to achieve including quick replies?

Shane, Community Manager

Re: Send a WhatsApp template using API.

jlorienz — Thu, 11 Sep 2025 12:40:27 GMT

@VMartins5 wrote:
I'm trying to send WhatsApp messages with quick replies via API (Meta and WhatsApp Business are already connected), but I can't find any instructions in the documentation. Cabinet Makeovers Maine

Using this endpoint:

POST /conversations/v3/conversations/threads/{threadId}/messages

The documentation doesn't explain how to include quick replies. I assumed the only way to do this is via pre-approved WhatsApp templates, but I don't see how to achieve it. I noticed the WHATSAPP_TEMPLATE_METADATA option under attachments, but I cannot find any explanation about how to use it.

Is there a documented way to send messages with quick replies?

WhatsApp quick replies (interactive buttons) can’t be sent with the Conversations API alone—you must use the WhatsApp Cloud or Business API interactive message format. Meta requires a pre-approved template with “interactive” type and buttons defined in the template’s JSON.

Re: Send a WhatsApp template using API.

FGless — Fri, 28 Nov 2025 10:37:23 GMT

I am also missing a way to use the API to send pre-approved templates. They all have an ID, both within HubSpot and Meta. Should be possible and is actually an important piece missing in the current WhatsApp integration.

Re: Send a WhatsApp template using API.

BérangèreL — Fri, 28 Nov 2025 11:00:36 GMT

Hi @FGless and Happy Friday! 🎊

Thank you for sharing your valuable feedback with the HubSpot Community, I’ve shared your input with our internal team as well.

I’d also love to connect you with our wonderful Top Experts: Hi @Anton, @sylvain_tirreau and @SteveHTM have any of you tried sending WhatsApp templates with quick replies via the HubSpot API?

If so, do you have any insights or tips you could share with @FGless, please?

Thank you all so much for your help, and wishing everyone a fantastic weekend!
Bérangère

Re: Send a WhatsApp template using API.

BérangèreL — Tue, 16 Dec 2025 11:55:35 GMT

Hi @FGless, I wanted to follow up and let you know that the API currently doesn’t support sending WhatsApp messages.

We wanted to let you know that we heard your feedback, it’s so valuable! In response, we’ve updated the "Send messages to threads" documentation to clarify this point.

Thanks again for sharing your feedback with us, we really appreciate it. It helps improve HubSpot for our whole Community.

Have a wonderful day! 🌞
Bérangère