Maytapi Changelog


We are announcing the new features and changes we have made on the WhatsApp API here


15.09.2026
New
  • Added the days parameter to /getConversations to return only conversations from the last N days
  • Added the refresh parameter to /getGroups and /getGroups/{conversation_id} to re-fetch group info from WhatsApp; cached data may still return @lid numbers even after they were converted to @c.us, so using refresh is left to your discretion
  • Increased the media send size limit in sendMessage to 50MB
  • Increased the incoming media content limit (when retrieving messages) from 40MB to 180MB
  • Enlarged the link preview size for channel_link messages in sendMessage (with automatic fallback to a smaller preview when the larger one cannot be sent)
  • Added mp3 audio support in sendMessage - mp3 files are now sent correctly
  • Added new proxy regions: South America (Ecuador exit), Colombia, South Africa, Argentina, North Africa (Egypt exit), Southeast Asia (Indonesia exit), Israel, Cameroon, United Kingdom, Brazil, Spain, Chile and India
  • Added an isVideo field to incoming call notifications (info messages with subtype call/ringing, call/miss, call/reject or call/accept) indicating whether the call is a video call
    • Fixed
  • Fixed the 'Contact could not found' error in sendMessage - the error no longer occurs when sending messages
  • Fixed the 'CreateGroup could not complete.' response in createGroup
  • Fixed an error with channel_text messages in sendMessage
  • Fixed an error with forward messages in sendMessage
  • Improved phone number validation in checkPhones
  • Fixed the call listener for ongoing calls (call/ringing)
    • 14.08.2026
    New
  • Added optional static IP for webhooks - you can now enable a static IP on the https://console.maytapi.com/developers/webhook page so that webhook deliveries reach you through a single channel (IP)
  • Added channel_question message type - you can now send answerable questions to WhatsApp channels; the question and its responses (with the responder's name, and id/phone when the number is saved) are returned in getMessage and channel/getMessages
    • Fixed
  • Fixed an issue where media occasionally did not appear when sending channel_media messages
  • Fixed an issue where message_edit updates were occasionally not delivered via webhook
  • Fixed a bug in the getGroups and getCommunities endpoints
  • Fixed the issue where products were not being added in the /catalog/addProduct endpoint
  • Applied a fix for the case where getCommunities sometimes returned participants in lid format - some participants may still be returned as lid
  • Fixed the issue where buttons messages were not being sent
    • 08.07.2026
    New
  • Added /{phone_id}/disappearingConversations/{conversation_id} endpoint to set the disappearing (ephemeral) messages timer for one-to-one conversations (off, 24 hours, 7 days or 90 days)
    • Fixed
  • Logout event detection made reliable - uncaught misses reduced to very low levels
  • Fixed issue where acknowledgement (ack) notifications were not being delivered
  • Fixed QR code detection
  • Fixed group creation issue in the createGroup endpoint
  • Fixed issue where call/ringing events were not reaching webhooks
  • Fixed vCard handling in the sendMessage endpoint
  • Fixed issue when editing the config of older groups
  • Fixed issue in community/add where invitations were not sent to invited people
    • 21.04.2026
    New
  • Added carousel message type to SendMessage endpoint for sending carousel messages
  • pinMessage is now delivered via webhook like reaction, pollVoteUpdate, message_edit and event_response - pinned message is identified via parentMsgId field
    • Fixed
  • When sending a reaction via SendMessage endpoint, if the target message cannot be found, webhook now returns 'Message could not found..!' error message
  • Improved and fixed the message loading function in reply_to, /getMessage/{msgId}, /getMessages/{conversation_id} and other related endpoints
  • Fixed media content retrieval issue for incoming media messages (occurred in limited mp4 messages)
  • Duration values in pinMessage via SendMessage are now converted to integer - legacy string format is still supported
    • 13.03.2026
    New
  • Added media link support for button messages - you can now include a media field with a URL in button message requests
    • Fixed
  • Fixed sticker and product message sending issues in SendMessage endpoint
  • Fixed /connectWithPhoneNumber endpoint functionality
  • Fixed models issue when sending media messages
    • 20.02.2026
    New
  • Added order message type reception and webhook delivery for tracking WhatsApp order messages
  • Added /{phone_id}/catalog/getOrders and /{phone_id}/catalog/getOrders/{orderId} endpoints for retrieving order information
  • Added catalog send functionality to SendMessage endpoint for sharing product catalogs in conversations
    • Fixed
  • Fixed channel discovery issue - all channels are now fully returned in responses
  • Fixed logout event detection - logout is now reliably detected in all scenarios
  • Fixed 500 error in /{phone_id}/getGroups/{conversation_id} endpoint
  • Fixed media sending error in SendMessage endpoint
  • Fixed BlockContact endpoint functionality
  • Fixed community permission validation error
    • 16.01.2026
    New
  • Added Send Media to Channel (Gif) functionality for sharing GIF content in channels
    • Fixed
  • Fixed /contacts/add, /contacts/remove, and /contacts/edit endpoint functionality for proper contact management
  • Fixed vote visibility issue in poll message type - votes are now properly displayed
  • Improved loading of previous messages for reply_to functionality
  • Fixed timestamp issue in message_edit webhook type
    • 15.12.2025
    New
  • Fixed @lid user ID returns in /contacts and /getConversations endpoints - now returning proper c.us or g.us format
  • Added description field to /getGroups endpoints for retrieving group descriptions
    • Fixed
  • Fixed /group/add endpoint functionality for proper group member management
  • Fixed @lid user ID returns in webhook conversation payloads - now returning c.us or g.us format instead of lid
  • Fixed @lid user ID returns in ack (acknowledgment) payloads - now returning c.us or g.us format
  • Fixed product message type functionality in SendMessage endpoint
    • 12.11.2025
    New
  • Added North Africa, Southeast Asia, and Argentina proxy regions to enhance global connectivity options
  • Added /{phone_id}/contact/add, /{phone_id}/contact/edit, and /{phone_id}/contact/remove endpoints to Contact Operations for managing contacts programmatically
    • Fixed
  • Fixed forwardMessage type functionality in SendMessage endpoint
  • Fixed /{phone_id}/group/approvalRequestList/{conversation_id} endpoint functionality for proper group approval request handling
  • Fixed /{phone_id}/connectWithPhoneNumber endpoint functionality to ensure stable phone number connections
  • Fixed automatic logout issue that occurred immediately after QR code scanning for better session management
    • 14.10.2025
    New
  • Added deleteForEveryone parameter to delete message type in SendMessage endpoint - set to true to delete messages for all participants, or false to delete only for yourself
  • Added isBusiness field to /{phone_id}/getContacts endpoint response for identifying business accounts
  • Added group/revoke_invite notification type to info-message webhooks to track group invite link changes and retrieve updated links
  • Introduced message-edit webhook type that returns both original and modified message content when messages are edited
  • Added /{phone_id}/group/deleteProfileImage endpoint for removing group profile pictures
  • Added /{phone_id}/clearConversations/{conversation_id} endpoint for clearing chat history of specific conversations
    • Fixed
  • Fixed issues with /{phone_id}/createGroup endpoint functionality
  • Fixed /{phone_id}/group/acceptInvite endpoint error handling
  • Fixed invite query parameter behavior in /{phone_id}/getGroups and /{phone_id}/getGroups/{conversation_id} endpoints - invite=true now correctly returns invite links when available
  • Fixed @lid user ID mapping in webhook message payloads to display correct user identifiers
  • Fixed error occurring when sending links through channel_text message type
  • Improved logout status tracking across all scenarios - logout events are now reliably reported in status change webhooks
    • 11.07.2025
    New
  • Added Channel Invite Message type to SendMessage endpoint for sending channel invitations
  • Added Channel Admin Invite Message type to SendMessage endpoint for sending admin invitations to channels
  • Added /{phone_id}/channel/demote endpoint for demoting channel administrators
  • Added /{phone_id}/channel/acceptAdminInvite endpoint for accepting admin invitations to channels
  • Added /{phone_id}/channel/revokeAdminInvite endpoint for revoking admin invitations from channels
  • Added channel-invite-message webhook type for capturing channel invitation messages
  • Added channel-admin-invite-message webhook type for capturing channel admin invitation messages
    • Fixed
  • Fixed group name change issue where group names were not being updated properly
    • 08.07.2025
    New
  • Added reaction and unreact message types to SendMessage endpoint
  • Added star message functionality with action parameter for starring/unstarring messages
  • Added createEvent message type for creating WhatsApp events with message, description, startTime, endTime, and location
  • Added event_response message type in webhook payloads for tracking event responses
  • Added channel_audio type to SendMessage endpoint for audio content in channels
    • Fixed
  • Fixed @lid user IDs in mentions support in webhook message payloads
  • Fixed @lid user IDs in info message participants field to show actual phone numbers
    • 05.05.2025
    New
  • Added isHd parameter to sendMedia endpoint to enable HD image sending when supported by WhatsApp (We don't convert images to HD, we only send them in HD if WhatsApp supports it)
  • Enhanced createGroup endpoint with options to set image and configuration during group creation
  • Added image return functionality to getGroups endpoint
    • Fixed
  • Fixed @lid user IDs in groups and webhook delivered messages
  • Resolved color issues in Labels section's createLabel and edit endpoints
  • Fixed QR display issue in /screen endpoint where a portion of the QR code was not visible
    • 22.04.2025
    New
  • Introduced locationLive webhook functionality to deliver shared live location updates through a new webhook type
  • Enhanced sendMessage endpoint with shortVideo support for more versatile media sharing options
  • Expanded webhook response types to include ptv (Video note) format, increasing the variety of video formats that can be captured
  • Added /createLabel endpoint for creating custom labels in WhatsApp Business with customizable names and colors
  • Implemented /label/edit endpoint for modifying existing label properties including name and color attributes
  • Added /label/remove endpoint for deleting single or multiple labels from the system simultaneously
  • Introduced /label/getlabelColors endpoint for retrieving all available color options for WhatsApp Business labels
    • Fixed
  • Resolved animation sticker rendering and processing issues for improved sticker functionality across platforms
    • 09.04.2025
    New
  • Changed webhook delivery format for reaction and pollVoteUpdate notifications - starting from 30.04.2025, these will only be delivered as sub-types under message type instead of under the ack structure
    • Fixed
  • Fixed issue with /group/acceptInvite endpoint, now properly handling ALREADY_JOINED_THE_GROUP, INVALID_INVITE_CODE and REMOVED_FROM_GROUP error scenarios for better group invitation management
  • Fixed issue with /group/acceptInviteV4 endpoint, now correctly returning ALREADY_JOINED_THE_GROUP and INVALID_INVITE_CODE error responses for improved error handling
    • 17.03.2025
    New
  • Introduced Community Chat Operations for managing communities
  • Added new Call Operations for improved call handling functionality
  • Added call/ringing status to info message for better call status tracking
    • Fixed
  • Fixed issue with /{phone_id}/group/revokeInvite endpoint, users can now successfully change their group invite links
    • 24.02.2025
    New
  • Added list type to SendMessage endpoint for sending structured list messages
  • Added story_text and story_media types to SendMessage endpoint for responding to contact stories
  • Introduced /{phone_id}/contactsStories or /{phone_id}/contactsStories/{conversation_id} endpoints to list your contacts' stories with their conversation IDs which can be used with story_text and story_media types for story responses
    • Fixed
  • Optimized performance for /{phone_id}/contactsStories and /{phone_id}/getStories endpoints to improve response times
  • Improved scanning performance for previously missed group_invite message types
    • 11.02.2025
    New
  • Introduced new channel statistics endpoint (/channel/statistics/{conversation_id}) providing comprehensive analytics including total followers, reach metrics, growth data, and geographical distribution of your channel audience
    • 22.01.2025
    New
  • Enhanced webhook message payloads with call/accept response support, enabling better tracking of accepted calls in your conversations
  • Implemented call/reject response functionality in webhook message payloads, allowing you to monitor rejected calls through the WhatsApp API
  • Expanded webhook message payload types to include group_invite and group_invite_v4, providing comprehensive group invitation details in your webhook responses
    • Fixed
  • Fixed and enhanced call/miss response handling in webhook message payloads to provide more reliable call status tracking
    • 09.01.2025
    New
  • Added support for GIF messages in the SendMessage endpoint, allowing you to send animated GIFs in your conversations through the WhatsApp API
    • Fixed
  • Fixed image responses in the getGroups/{conversation_id} endpoint
  • Added full support for sticker type in SendMessage endpoint
    • 17.12.2024
    New
  • JSON Escape/Unescape Tool is now available for processing JSON data efficiently. The tool helps developers properly format JSON strings, handle special characters, and validate JSON data with instant preview and file saving options. (New Tool)
    • Fixed
  • Fixed mentions support in webhook message payloads
  • Fixed media retrieval issues when getting content from channels (it's recommended to provide a count value for retrieved media)
  • Fixed group profile image update issues in /group/setProfileImage endpoint - group images can now be changed successfully
    • 21.12.2023
    New
  • WhatsApp channels are now available in our WhatsApp API, you can visit the document and see it.
  • You can get detailed information about your Whatsapp stories, and you can also share media (images, videos) in your stories whenever you want.
  • You can receive reactions to your messages in WhatsApp conversations through WhatsApp API
  • You can track the votes given to the polls shared on WhatsApp in real-time through WhatsApp API
  • Stories of the users in your contact list are now accessible through the WhatsApp API. You can review the /contactsStories section in the documentation under Story Operations (Beta) for more details.
  • You can send stickers through the sticker message section in the 'SendMessage' part.
  • Now, you can display the typing indicator for your text messages to the other party.
  • We've set up the process of sending links to channels.
  • You can obtain detailed information about your messages through endpoints with the 'Message Info'
  • Now, you can become a partner with our API and manage your own phones without making any upfront payments. For detailed information, you can visit page Whatsapp API Partner