Brevo PHP SDK v4.0.7: ContactsClient::createContact() throws "Failed to deserialize response: Syntax error"

TL;DR

Upgrade with composer require getbrevo/brevo-php:^4.0.11 and the exception goes away. It was fixed in v4.0.11, where the SDK handles those responses gracefully instead of throwing during deserialization.

Steps

1. On getbrevo/brevo-php v4.0.7 with PHP 8.4, calling ContactsClient::createContact() throws Brevo\Exceptions\BrevoException: Failed to deserialize response: Syntax error with a nested JsonException(code: 4). The HTTP request itself succeeds and the contact is created or updated, but the SDK then chokes while parsing the response body. This happens on the upsert flow with updateEnabled set to true, when the API returns an empty or non-JSON success response that the deserializer does not expect.
2. This is an SDK bug, not your code: v4.0.7 tries to JSON-decode success responses that can be empty or non-JSON. It was fixed in v4.0.11, where the SDK handles those responses gracefully instead of throwing during deserialization. Upgrade with composer require getbrevo/brevo-php:^4.0.11 and the exception goes away. The Brevo team confirmed the fix on the issue thread.

When to use

You are seeing this: On getbrevo/brevo-php v4.0.7 with PHP 8.4, calling ContactsClient::createContact() throws Brevo\Exceptions\BrevoException: Failed to deserialize response: Syntax error with a nested JsonException(code: 4). Use this skill when you run into "Brevo PHP SDK v4.0.7: ContactsClient::createContact() throws "Failed to deserialize response: Syntax error"".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

Versions mentioned in the source: getbrevobrevo-php v4.0.7, v4.0.11, getbrevobrevo-php 4.0.11. If you are on something much newer or older, the details may have shifted.

Why this happens

On getbrevo/brevo-php v4.0.7 with PHP 8.4, calling ContactsClient::createContact() throws Brevo\Exceptions\BrevoException: Failed to deserialize response: Syntax error with a nested JsonException(code: 4).

In the thread Brevo PHP SDK v4.0.7: ContactsClient::createContact() throws "Failed to deserialize response: Syntax error", the question was: On getbrevo/brevo-php v4.0.7 with PHP 8.4, calling ContactsClient::createContact() throws Brevo\Exceptions\BrevoException: Failed to deserialize response: Syntax error with a nested JsonException(code: 4). The HTTP request itself succeeds and the contact is created or updated, but the SDK then chokes while parsing the response body. This happens on the upsert flow with updateEnabled set to true, when the API returns an empty or non-JSON success response that the deserializer does not expect. The verified resolution: This is an SDK bug, not your code: v4.0.7 tries to JSON-decode success responses that can be empty or non-JSON. It was fixed in v4.0.11, where the SDK handles those responses gracefully instead of throwing during deserialization. Upgrade with composer require getbrevo/brevo-php:^4.0.11 and the exception goes away. The Brevo team confirmed the fix on the issue thread. Original discussion: https://vectle.com/threads/thr_y2YV34Crv157UOssCDtq4A