About the limitations
The official WhatsApp Business API has some limitations compared to Z-API (which uses an unofficial connection). Some features that existed in Z-API are not supported by the official API and, therefore, are not available in .
Below we list the affected features so you can assess the impact on your integration before migrating.
Messages
| Feature | Z-API Route | Status |
|---|
| Delete message | DELETE /messages | ❌ Not supported |
| Edit message | editMessageId attribute in send endpoints | ❌ Not supported |
| Forward message | POST /forward-message | ❌ Not supported |
| Send GIF | POST /send-gif | ❌ Not supported |
| Send PTV (circular video) | POST /send-ptv | ❌ Not supported |
| Edit document description | editDocumentMessageId attribute in send-document | ❌ Not supported |
| Send OTP via button | POST /send-button-otp | ⚠️ Template only |
| Private reply in group | privateAnswer attribute in reply-message | ❌ Not supported |
| Send poll / vote | POST /send-poll | ❌ Not supported |
| Pin message | POST /pin-message | ❌ Not supported |
| Send / edit / reply event | POST /send-event | ❌ Not supported |
| Channel admin invite | POST /send-newsletter-admin-invite | ❌ Not supported |
| Feature | Z-API Route | Status |
|---|
| List contacts | GET /contacts?page=&pageSize= | ❌ Not supported |
| Add contacts | POST /contacts/add | ❌ Not supported |
| Remove contacts | DELETE /contacts/remove | ❌ Not supported |
| Contact metadata | GET /contacts/{phone} | ❌ Not supported |
| Profile picture | GET /profile-picture?phone={phone} | ❌ Not supported |
| Check WhatsApp number | GET /phone-exists/{phone} | ❌ Not supported |
| Check numbers in batch | POST /phone-exists-batch | ❌ Not supported |
| Block / unblock contact | POST /contacts/modify-blocked | ❌ Not supported |
| Report contact | POST /contacts/{phone}/report | ❌ Not supported |
Groups
The official WhatsApp API supports groups, but with limited features compared to Z-API. Features supported by the official API are marked as In development and will be available soon in .
| Feature | Z-API Route | Status |
|---|
| Create group | POST /create-group | 🔧 In development |
| Group metadata | GET /group-metadata/{phone} | 🔧 In development |
| Remove participants | POST /remove-participant | 🔧 In development |
| Approve participants | POST /approve-participant | 🔧 In development |
| Reject participants | POST /reject-participant | 🔧 In development |
| Get invite link | GET /group-invitation-link/{id} | 🔧 In development |
| Redefine invite link | POST /redefine-invitation-link/{id} | 🔧 In development |
| Update description | POST /update-group-description | 🔧 In development |
| Update group name | POST /update-group-name | 🔧 In development |
| Update group photo | POST /update-group-photo | 🔧 In development |
| List groups | GET /groups | ❌ Not supported |
| Group metadata (light) | GET /light-group-metadata/{phone} | ❌ Not supported |
| Group settings | POST /update-group-settings | ❌ Not supported |
| Add participants | POST /add-participant | ❌ Not supported |
| Promote admin | POST /add-admin | ❌ Not supported |
| Remove admin | POST /remove-admin | ❌ Not supported |
| Leave group | POST /leave-group | ❌ Not supported |
| Mention member | POST /send-text | ❌ Not supported |
| Mention group | POST /send-text | ❌ Not supported |
| Metadata by invite | GET /group-invitation-metadata?url= | ❌ Not supported |
| Accept invite | GET /accept-invite-group?url= | ❌ Not supported |
Business
Company profile
| Feature | Z-API Route | Status |
|---|
| Business profile data | GET /business/profile | 🔧 In development |
| Update company description | POST /business/company-description | 🔧 In development |
| Update company email | POST /business/company-email | 🔧 In development |
| Update business address | POST /business/company-address | 🔧 In development |
| Update company websites | POST /business/company-websites | 🔧 In development |
| Assign categories | POST /business/categories | 🔧 In development |
Catalog and products
| Feature | Z-API Route | Status |
|---|
| Create/edit product | POST /products | 🔧 In development |
| List products | GET /catalogs | 🔧 In development |
| Get product by ID | GET /products/{productId} | 🔧 In development |
| Delete product | DELETE /products/{productId} | 🔧 In development |
| Catalog config | POST /catalogs/config | 🔧 In development |
| Create collection | POST /catalogs/collection | 🔧 In development |
| List collections | GET /catalogs/collection | 🔧 In development |
| Delete collection | DELETE /catalogs/collection/{id} | 🔧 In development |
| Edit collection | POST /catalogs/collection-edit/{id} | 🔧 In development |
| List collection products | GET /catalogs/collection-products/{phone} | 🔧 In development |
| Add product to collection | POST /catalogs/collection/add-product | 🔧 In development |
| Remove product from collection | POST /catalogs/collection/remove-product | 🔧 In development |
| List products (phone) | GET /catalogs/{phone} | ❌ Not supported |
| List products V2 | POST /catalogs | ❌ Not supported |
| List products V2 (phone) | POST /catalogs/{phone} | ❌ Not supported |
Labels
| Feature | Z-API Route | Status |
|---|
| List tags | GET /tags | ❌ Not supported |
| Create tag | POST /business/create-tag | ❌ Not supported |
| Edit tag | POST /business/edit-tag/{tagId} | ❌ Not supported |
| Delete tag | DELETE /business/tag/{tagId} | ❌ Not supported |
| Assign tag to chat | PUT /chats/{phone}/tags/{tag}/add | ❌ Not supported |
| Remove tag from chat | PUT /chats/{phone}/tags/{tag}/remove | ❌ Not supported |
| Tag colors | GET /business/tags/colors | ❌ Not supported |
Other
| Feature | Z-API Route | Status |
|---|
| Chat notes | POST /chats/{phone}/notes | ❌ Not supported |
| Update business hours | POST /business/hours | ❌ Not supported |
| List categories | GET /business/available-categories | ❌ Not supported |
Status
| Feature | Z-API Route | Status |
|---|
| Send text status | POST /send-text-status | ❌ Not supported |
| Send image status | POST /send-image-status | ❌ Not supported |
| Send video status | POST /send-video-status | ❌ Not supported |
| Reply status with text | POST /reply-status-text | ❌ Not supported |
| Reply status with GIF | POST /reply-status-gif | ❌ Not supported |
| Reply status with sticker | POST /reply-status-sticker | ❌ Not supported |
Channels (Newsletter)
| Feature | Z-API Route | Status |
|---|
| Create channel | POST /create-newsletter | ❌ Not supported |
| Update channel picture | POST /update-newsletter-picture | ❌ Not supported |
| Update channel name | POST /update-newsletter-name | ❌ Not supported |
| Update channel description | POST /update-newsletter-description | ❌ Not supported |
| Follow channel | PUT /follow-newsletter | ❌ Not supported |
| Unfollow channel | PUT /unfollow-newsletter | ❌ Not supported |
| Mute channel | PUT /mute-newsletter | ❌ Not supported |
| Unmute channel | PUT /unmute-newsletter | ❌ Not supported |
| Delete channel | DELETE /delete-newsletter | ❌ Not supported |
| Channel metadata | GET /newsletter/metadata/{id} | ❌ Not supported |
| List channels | GET /newsletter | ❌ Not supported |
| Search channels | POST /search-newsletter | ❌ Not supported |
| Channel settings | POST /newsletter/settings/{id} | ❌ Not supported |
| Accept admin invite | POST /newsletter/accept-admin-invite/{id} | ❌ Not supported |
| Remove channel admin | POST /newsletter/remove-admin/{id} | ❌ Not supported |
| Revoke admin invite | POST /newsletter/revoke-admin-invite/{id} | ❌ Not supported |
| Transfer ownership | POST /newsletter/transfer-ownership/{id} | ❌ Not supported |
Chats
| Feature | Z-API Route | Status |
|---|
| List chats | GET /chats | ❌ Not supported |
| Chat metadata | GET /chats/{phone} | ❌ Not supported |
| Read chat | POST /modify-chat | ❌ Not supported |
| Archive chat | POST /modify-chat | ❌ Not supported |
| Pin chat | POST /modify-chat | ❌ Not supported |
| Mute chat | POST /modify-chat | ❌ Not supported |
| Clear chat | POST /modify-chat | ❌ Not supported |
| Delete chat | POST /modify-chat | ❌ Not supported |
| Chat expiration | POST /send-chat-expiration | ❌ Not supported |
Communities
| Feature | Z-API Route | Status |
|---|
| Create community | POST /communities | ❌ Not supported |
| List communities | GET /communities | ❌ Not supported |
| Link groups | POST /communities/link | ❌ Not supported |
| Unlink groups | POST /communities/unlink | ❌ Not supported |
| Community metadata | GET /communities-metadata/{id} | ❌ Not supported |
| Redefine invitation link | POST /redefine-invitation-link/{id} | ❌ Not supported |
| Add participants | POST /add-participant | ❌ Not supported |
| Remove participants | POST /remove-participant | ❌ Not supported |
| Promote admin | POST /add-admin | ❌ Not supported |
| Remove admin | POST /remove-admin | ❌ Not supported |
| Community settings | POST /communities/settings | ❌ Not supported |
| Deactivate community | DELETE /communities/{id} | ❌ Not supported |
| Update description | POST /update-community-description | ❌ Not supported |
Calls
| Feature | Z-API Route | Status |
|---|
| Make call | POST /send-call | ❌ Not supported |
| Generate call token | GET /call-token | ❌ Not supported |
Privacy
| Feature | Z-API Route | Status |
|---|
| Disallowed contacts | GET /privacy/disallowed-contacts | ❌ Not supported |
| Last seen | POST /privacy/last-seen | ❌ Not supported |
| Profile picture visibility | POST /privacy/photo | ❌ Not supported |
| About visibility | POST /privacy/description | ❌ Not supported |
| Group add permission | POST /privacy/group-add | ❌ Not supported |
| Online visibility | POST /privacy/online | ❌ Not supported |
| Read receipts | POST /privacy/read-receipts | ❌ Not supported |
| Messages duration | POST /privacy/messages-duration | ❌ Not supported |
These limitations come from the official WhatsApp Business API (Meta) itself, not from . If Meta makes these features available in the future, will incorporate them.
