WhatsApp Business Platform > On-Premises API

We are sunsetting On-Premises API. Refer to our On-Premises API Sunset document for details, and to learn how to migrate to our next-generation Cloud API.

On-Premises API Changelog

Recommended version: v2.59.2

This changelog covers what has changed in the WhatsApp On-Premises API client and AWS/Azure/GCP Templates.

WhatsApp Business API Client

On-Premises API users must install new client versions to keep using the API without disruptions. Deprecated versions of the API client are not supported anymore. Should a client lose connection after the expiration date, the deprecated client will not be able to connect to the server and cannot send or receive messages.

The On-Premises client now offers support for MySQL 8. It is possible to migrate any version of the On-Premises client from MySQL 5 to MySQL 8. It's important to keep in mind that once a database has been migrated to MySQL 8, it is not possible to revert it back to MySQL 5. As a precaution, please ensure you create a backup of the database prior to initiating the migration process.

Warning: We are aware of an issue affecting GCP templates and MySQL 8. More information in our template github project.

Version	Date Introduced	Available Until
v2.59.2 (Recommended)	Oct 31, 2024	April 24, 2025
v2.59.1	Oct 08, 2024	April 24, 2025
v2.57.2	July 09, 2024	Jan 23, 2025
v2.55.1	April 09, 2024	Nov 24, 2024
Archive

Troubleshooting & Known Issues

Please check the troubleshooting page for known issues.

WhatsApp On-Premises API Client Changes

Oct 31, 2024 (v2.59.2)

Version 2.59.2 is now available and includes:

PostgreSQL AWS connection issue fix
Upgrade several image packages, covering security vulnerabilities

July 09, 2024 (v2.57.2)

Oct 08, 2024 (v2.59.1)

Version 2.59.1 is now available and includes:

Various fixes

July 09, 2024 (v2.57.2)

Version 2.57.2 is now available and includes:

Fix for coreapp crash issues

April 09, 2024 (v2.55.1)

Version 2.55.1 is now available and includes:

Fix to prevent same media to be uploaded several times in particular scenarii.
Fix to prevent webhooks to be sent indefinitely if the webhook server on the business side is not available.

Amazon Web Services Templates

Current Version: 3.0.3

What's included in the Amazon Web Services (AWS) - Cloud Formation (CFN) templates:

Release Version	Date Introduced	Changes
`3.0.3`	Aug 1, 2024	Users now require CentOS 9 subscription on their AWS account. [Link]
`3.0.1`	Aug 17, 2023	Update templates to use MySQL 8
`3.0.0`	Nov 18, 2022	Rework of Cloud Formation (CFN) templates Reduce the cost by host sharing shards at different throughputs Reduce the cost by scaling down shards / hosts
`2.3.7`	Apr 26, 2022	Change details

GCP Deployment Templates

Current Version: 1.0.1

Release Version Date Introduced Changes

Release Version	Date Introduced	Changes
`1.0.1`	Aug 17, 2023	Update templates to use MySQL 8
`1.0.0`	Nov 18, 2022	Rework of template Reduce the cost by host sharing shards at different throughputs Reduce the cost by scaling down shards / hosts

1.0.1

Aug 17, 2023

Update templates to use MySQL 8

1.0.0

Nov 18, 2022

Rework of template

Reduce the cost by host sharing shards at different throughputs
Reduce the cost by scaling down shards / hosts

Azure Deployment Templates