Skip to main content

Release notes

A list of all the changes and enhancements that were introduced in our API. Use it to check whenever new endpoints are added, or changes are made.

September 10, 2026​

🛠️ Changes​

  • POST /messages/send now returns 402 Payment Required with the whatsapp_wallet_depleted_credit error code when a template message is sent from an account whose WhatsApp credit balance is exhausted. Regular messages are not affected, and template sends resume as soon as credit is added.

August 7, 2026​

✨ What's new​

  • GET /contacts now supports cursor pagination: every response includes a meta.next token that can be passed back through the new after parameter to fetch the next batch of contacts. This makes it possible to retrieve the complete contact list, past the 10,000-contact limit of page-based pagination.

July 1, 2026​

✨ What's new​

  • Added note field to the Contact object type. It can now be set when creating or updating a contact (free-text, up to 1000 characters).

June 22, 2026​

✨ What's new​

  • Added GET /contacts/bsuid/:bsuid endpoint to look up a contact by its WhatsApp Business Suite User ID (BSUID).
  • Added bsuid field to the Contact object type, returned for WhatsApp Cloud API contacts with a known BSUID.
  • POST /messages/send now accepts a bsuid parameter as an alternative to to for identifying the recipient.

March 3, 2026​

✨ What's new​

  • Added include_field_types query parameter to GET /contacts and GET /contacts/:uuid. When set to true, the response includes a customFieldsMetadata attribute with the typed value, field type, and available options (for dropdown and checkbox fields) for each custom field.
  • Custom field values are now validated based on their field type when creating or updating contacts. Supported types: text, email, number, date, dropdown, checkbox.

February 19, 2026​

✨ What's new​

  • Added closing reason field to conversation_closed webhook event.

February 10, 2026​

✨ What's new​

  • Added GET /plan endpoint to retrieve the current account's plan details, including active users and team breakdown.

February 6, 2026​

🛠️ Changes​

  • GET /channels endpoint now supports active parameter to filter channels by their active status.

December 22, 2025​

✨ What's new​

May 20, 2025​

February 17, 2025​

🛠️ Changes​

  • Added the possibility to unassign a custom status from a user by passing null as the custom_status_uuid parameter on the Users API.

February 5, 2025​

✨ What's new​

January 6, 2025​

✨ What's new​

December 5, 2024​

✨ What's new​

November 26, 2024​

✨ What's new​

November 21, 2024​

✨ What's new​

November 19, 2024​

✨ What's new​

November 18, 2024​

✨ What's new​

September 24, 2024​

✨ What's new​

  • Added conversationHref to all the endpoints that return a Contact object; this field links to the conversation associated with the contact on Callbell dashboard.
  • The field is also present in all webhooks related to contacts, messages and conversations.
  • Added a new field conversation to the Send Message endpoint request body. This fields allows to return the conversation in the response.

July 30, 2024​

✨ What's new​

July 25, 2024​

✨ What's new​

  • Added code snippets for C#, Java and Rust

May 15, 2024​

✨ What's new​

March 11, 2024​

✨ What's new​

  • GET Contact Bot endpoint to get the bot associated with a specific contact.
  • POST Contact Bot endpoint to change the status of the bot associated with a specific contact.

March 5, 2024​

🛠️ Changes​

  • Get Contact By Phone endpoint now supports the channel_uuid parameter to search the contact by phone number and channel.

February 22, 2024​

✨ What's new​

February 20, 2024​

✨ What's new​

  • Added a new endpoint for listing all the team members belonging to a team.

🛠️ Changes​

  • Send Message endpoint now supports an optional fields parameter to specify which fields to include in the response. This is useful to reduce the response size and speed up the API calls. Currently only contact is supported.

February 14, 2024​

✨ What's new​

  • Create contact endpoint now supports the channel_uuid parameter to create a contact associated with a specific channel.

February 9, 2024​

✨ What's new​

  • Channels API to manage your Callbell Channels programmatically. Use this endpoint to list, show and update your channels.

🛠️ Changes​

  • Send Messages endpoint now supports the channel_uuid parameter to send a message to a specific channel.

January 11, 2024​

✨ What's new​

January 8, 2024​

✨ What's new​

Added information and examples about how to use Callbell with Zapier.

January 4, 2024​

✨ What's new​

  • Contact messages API to fetch all the messages of a contact. This endpoint is useful to fetch all the messages of a contact, the result is paginated and sorted by date.

December 19, 2023​

✨ What's new​

December 14, 2023​

🛠️ Changes​

  • Message Created Webhook event now includes the whole contact reference. This is useful to have further information about the contact without having to perform an extra API call.

November 30, 2023​

✨ What's new​

November 7, 2023​

✨ What's new​

June 29, 2023​

🛠️ Changes​

June 15, 2023​

✨ What's new​

April 5, 2023​

✨ What's new​

  • The assignedUser attribute has been added to the Contact object
  • Users can now be assigned to a contact during creation or update by providing the assigned_user parameter with a user's email (eg. john.doe@email.com). Ensure that the provided email corresponds to a confirmed user in your account.
  • To unassign a user from a contact during an update, include the unassign_user parameter in the request body and set its value to true. This action will remove the assigned user from the contact.

March 3, 2023​

✨ What's new​

  • Multi-language code snippets (curl, node, go, ruby, php, python) for all the requests
  • Release Notes section

🛠️ Changes​

  • Contact now includes custom_fields
  • custom_fields, tags can be passed in the body when creating or creating a contact
  • phone_number of Contact can't be updated anymore

January 17, 2023​

✨ What's new​

🛠️ Changes​

November 11, 2022​

✨ What's new​

October 18, 2022​

✨ What's new​