New Safe Mode warms up new numbers to cut the risk of a WhatsApp ban. Learn more →
99.98%
enEnglish trTürkçe esEspañol ptPortuguês roRomână ruРусский
Start free
EN TR ES PT RO RU
Start free Log in
Changelog

Maytapi Changelog

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

  1. November 2026

    6 New8 Fixed

    New
    • Message WhatsApp usernames directly - sendMessage now accepts a username as to_number (prefix it with @, e.g. @john_doe; add the 4-digit key after a colon for key-protected usernames, e.g. @john_doe:1234), and webhook payloads now carry the sender's username in the user object so you can match conversations by username
    • Motion photos (Android Motion Photo / iPhone Live Photo) are now delivered in full - the incoming image message carries isMotion: true and a motionUrl with the short MP4 of the moving part, in webhooks, in the quoted context of replies and in getConversations / getMessages results
    • Send real voice notes - the new audio type in sendMessage delivers the file as a voice message (microphone bubble) instead of an audio attachment; keep using media when you want a regular audio file
    • Know the state of every chat - getConversations now returns isFavorite, isPinned, isArchived, isMuted, muteUntil and ephemeral for each conversation
    • Disappearing-message changes reach your webhook - when the disappearing-message timer of a chat or group is changed you receive an info message with subtype chat/disappearing and the new duration in seconds (ephemeral)
    • Resolve usernames and numbers both ways - the new /getContacts/usernameToPhone/{username} endpoint turns a WhatsApp username into its identity (phone, id, lid; keyRequired: true when a key-protected username needs its key) and /getContacts/phoneToUsername/{number} returns the username of a phone number
    Fixed
    • Fixed buttons messages with media, sticker messages and catalog edit operations
    • Fixed the QR code not being shown on the connection screen
    • Fixed catalogs not loading on some numbers and added paging to catalog/getCollections - use page, limit (max 50) and count (products per collection, max 100) to browse large catalogs; retrieval is now faster and large catalogs load completely
    • Fixed the catalog/getOrders and catalog/getOrders/{orderId} endpoints
    • Message delivery, already highly reliable, got even better - media processing no longer holds back incoming messages, and a new fallback guarantees that the message content always reaches you
    • Fixed pinMessage not applying in some rare cases
    • Improved the reliability of the reaction, pollVoteUpdate and event_response webhooks - the underlying listeners were reworked so these events are delivered consistently
    • Fixed pollVoteUpdate not being delivered when a vote is retracted

  2. October 2026

    15 New11 Fixed

    New
    • Mention everyone at once - sendMessage now supports @all, so a single message can notify every member of a group without listing each number; see the 'Mention Everyone Message' example
    • Run quizzes in your WhatsApp channels - the new channel_quiz type in sendMessage lets you post a question with a correct answer, and getMessage / channel/getMessages return the options, the correct option and the vote counts so you can track results
    • Join the conversation under your announcements - sendMessage can now post comments on community announcement-group messages (see the 'Comment Message' example), and message responses include replyCount and the full comments thread
    • Labels now reach your webhook - whenever a label is added to or removed from a chat you receive a label/add or label/remove message, so you can mirror your WhatsApp labels in your own CRM in real time
    • Full control over the profile - read and update the display name, the about text and the WhatsApp username of the connected number with the new getProfileName / setProfileName, getProfileAbout / setProfileAbout and getProfileUsername / setProfileUsername endpoints (getProfileAbout/{conversation_id} also reads another contact's about)
    • See who you have blocked - the new /{phone_id}/getBlockContacts endpoint returns the blocked contacts of the number
    • Know your new-chat quota before you hit it - /{phone_id}/getNewChatLimit shows whether WhatsApp limits first messages to new contacts for the number, how much of the quota is used and when the cycle resets. This limit is currently in testing by WhatsApp and for now only appears on new WhatsApp accounts
    • Manage the business profile via the API - getBusinessProfile, getBusinessProfile/{conversation_id} and setBusinessProfile let you read your own or another business's public profile and update description, address, email, websites and business hours
    • Decide who sees your stories - getStoryPrivacy and setStoryPrivacy manage the story audience (all contacts, an allow list or a deny list) of the number
    • Discover and join community sub-groups - community/unjoinedSubGroups/{conversation_id} lists the sub-groups you have not joined yet and community/joinSubGroup joins one of them
    • Richer stories - createStory now supports audio stories (currently OGG/Opus .oga files only), a custom backgroundColor for text stories and a per-story audience with contacts / excludeContacts
    • Groups know their community - getGroups now returns communityId and isCommunityAnnounce so you can tell which groups belong to a community and which one is its announcement group
    • Filter contacts by kind - the new type parameter (group or contact) in /getContacts returns only the entries you need
    • Choose between speed and freshness - /getConversations/{conversation_id} accepts fromCache and fresh so you can serve cached data instantly or force a live read
    • More exit points around the world - new proxy regions: Russia, Mexico, Hong Kong, Singapore, Vietnam, Ukraine, United States, Italy, Malaysia, Lebanon and Madagascar
    Fixed
    • Fixed createGroup
    • Fixed the automatic logout issue of instances
    • Applied an advanced fix for the conn-retry state - instances now have much more stable WhatsApp socket connections
    • Added a fallback for returning media content as a link - a link is now returned whenever the instance is connected (this was already highly reliable)
    • Fixed getGroups and getCommunities
    • Fixed profileImage actions
    • Fixed call/start
    • Fixed the acceptGroupInvite and createCallLink endpoints
    • Fixed incoming media not being written with the correct file extension (.jpeg, .mp4) when the caption contained emojis
    • Fixed the cipherText issue that caused instances to get stuck
    • Fixed the deactiveCommunity endpoint

  3. September 2026

    8 New6 Fixed

    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)

  4. August 2026

    2 New6 Fixed

    New
    • Added optional static IP for webhooks - you can now enable a static IP on the 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

  5. July 2026

    1 New8 Fixed

    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

  6. April 2026

    2 New4 Fixed

    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

  7. March 2026

    1 New3 Fixed

    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

  8. February 2026

    3 New6 Fixed

    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

  9. January 2026

    1 New4 Fixed

    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

  10. December 2025

    2 New4 Fixed

    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

  11. November 2025

    2 New4 Fixed

    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

  12. October 2025

    6 New6 Fixed

    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

  13. July 2025

    7 New1 Fixed

    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

  14. July 2025

    5 New2 Fixed

    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

  15. May 2025

    3 New3 Fixed

    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

  16. April 2025

    7 New1 Fixed

    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

  17. April 2025

    1 New2 Fixed

    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

  18. March 2025

    3 New1 Fixed

    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

  19. February 2025

    3 New2 Fixed

    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

  20. February 2025

    1 New

    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

  21. January 2025

    3 New1 Fixed

    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

  22. January 2025

    1 New2 Fixed

    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

  23. December 2024

    1 New3 Fixed

    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

  24. December 2023

    9 New

    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
Start using the WhatsApp API

Get your key, send your first message in ten minutes

No approval, no templates, no card. Every endpoint is open for three days.