Skip to main content

API Changelog

Track all updates, new features, and improvements to the WhatsApp API.

Version 2.0 - February 2026​

🎉 Major Feature Release​

This release adds 21 new endpoints across 4 major feature categories, significantly expanding the API's capabilities.

✨ New Features​

Profile Management (5 endpoints)​

Manage your WhatsApp profile programmatically.

  • ✅ GET /sessions/{id}/profile - Get authenticated user's profile
  • ✅ PUT /sessions/{id}/profile/name - Update profile display name
  • ✅ PUT /sessions/{id}/profile/status - Update profile status/about
  • ✅ PUT /sessions/{id}/profile/picture - Update profile picture (URL or base64)
  • ✅ DELETE /sessions/{id}/profile/picture - Remove profile picture

Use Cases:

  • Automated profile updates
  • Branding consistency
  • Profile synchronization across platforms

View Profile Documentation →

Pairing Code Authentication (1 endpoint)​

Alternative authentication method without QR code scanning.

  • ✅ POST /sessions/{id}/auth/request-code - Get 8-digit pairing code

Benefits:

  • No camera/QR scanning required
  • Perfect for headless servers
  • Easier automation
  • Better for CLI applications

How it works:

  1. Request pairing code with phone number
  2. Enter code in WhatsApp app
  3. Session authenticated

View Authentication Documentation →

Contact Operations (4 endpoints)​

Enhanced contact management capabilities.

  • ✅ POST /sessions/{id}/contacts/block - Block a contact
  • ✅ POST /sessions/{id}/contacts/unblock - Unblock a contact
  • ✅ GET /sessions/{id}/contacts/{jid}/profile-picture - Get contact's profile picture URL
  • ✅ GET /sessions/{id}/contacts/{jid}/about - Get contact's status/about text

Use Cases:

  • Contact verification
  • Profile data collection
  • Automated contact management
  • User information enrichment

View Contacts Documentation →

Chat Management (11 endpoints)​

Comprehensive chat and message management.

Chat Operations:

  • ✅ DELETE /sessions/{id}/chats/{chatId} - Delete entire chat
  • ✅ POST /sessions/{id}/chats/{chatId}/archive - Archive chat
  • ✅ POST /sessions/{id}/chats/{chatId}/unarchive - Unarchive chat
  • ✅ POST /sessions/{id}/chats/{chatId}/unread - Mark chat as unread

Message Operations:

  • ✅ DELETE /sessions/{id}/chats/{chatId}/messages/{messageId} - Delete message
  • ✅ PUT /sessions/{id}/chats/{chatId}/messages/{messageId} - Edit message text
  • ✅ POST /sessions/{id}/chats/{chatId}/messages/{messageId}/pin - Pin message
  • ✅ POST /sessions/{id}/chats/{chatId}/messages/{messageId}/unpin - Unpin message
  • ✅ PUT /sessions/{id}/messages/{messageId}/reaction - React with emoji
  • ✅ POST /sessions/{id}/chats/{chatId}/messages/{messageId}/star - Star/unstar message

Use Cases:

  • Chat organization
  • Message moderation
  • Automated reactions
  • Important message highlighting

View Chat Management Documentation →

🔧 Improvements​

Enhanced Health Endpoint​

The /health endpoint now provides comprehensive system metrics:

  • CPU Usage - Real-time CPU utilization percentage
  • Memory Usage - Total, used, free memory with percentages
  • Disk Usage - Disk space monitoring
  • System Info - Platform, uptime, Node.js version
  • Load Average - 1, 5, 15-minute load averages
  • Health Status - healthy, warning, or critical based on thresholds

Example Response:

{
  "status": "healthy",
  "timestamp": "2026-02-04T06:17:00.000Z",
  "cpu": {
    "usage": 25.5,
    "cores": 8,
    "model": "Intel(R) Core(TM) i7-9750H"
  },
  "memory": {
    "total": "16 GB",
    "used": "8.5 GB",
    "usagePercent": 53.12
  },
  "disk": {
    "total": "500 GB",
    "usagePercent": 50.0
  }
}

📚 Documentation Updates​

  • ✅ New Profile Management documentation
  • ✅ New Authentication Methods guide (QR vs Pairing Code)
  • ✅ New Contact Operations documentation
  • ✅ New Chat Management documentation
  • ✅ Updated Swagger/OpenAPI specifications
  • ✅ Added comprehensive code examples (JavaScript, Python)
  • ✅ Created testing guides and best practices

🔄 Breaking Changes​

None - All new features are additive and backward compatible.

📊 Statistics​

  • Total New Endpoints: 21
  • New API Categories: 4
  • Code Examples Added: 50+
  • Documentation Pages: 4 new pages
  • Lines of Code: ~800+ added

Version 1.0 - January 2026​

Initial Release​

Core Features​

Session Management:

  • Create and manage WhatsApp sessions
  • QR code authentication
  • Session lifecycle management
  • Multi-session support

Messaging:

  • Send text messages
  • Send media (images, videos, audio, documents)
  • Send stickers
  • Send contacts and locations
  • Send polls (native WhatsApp feature)
  • Button messages (deprecated)
  • Interactive messages (deprecated)
  • List messages (deprecated)

Group Management:

  • Create groups
  • Add/remove participants
  • Update group settings
  • Promote/demote admins
  • Get group invite links

Webhooks:

  • Connection events
  • Message events
  • Group events
  • Delivery receipts
  • Read receipts

Admin Features:

  • API key management
  • Rate limiting
  • Usage tracking
  • Trial accounts

Upcoming Features​

Planned for Future Releases​

Status/Stories Management​

  • Send text status
  • Send image/video status
  • Delete status
  • View status updates

Channels/Newsletters​

  • Channel creation
  • Channel following
  • Channel search
  • Channel message preview

Advanced Features​

  • Forward messages
  • Poll voting
  • Custom link previews
  • Call management
  • Group settings (admin-only features)

Enhanced Analytics​

  • Message delivery analytics
  • Session health monitoring
  • Usage statistics dashboard
  • Performance metrics

Migration Guides​

Migrating to v2.0​

No migration required! All v1.0 endpoints remain functional. Simply start using new endpoints as needed.

Adopting New Features​

  1. Profile Management

    • Replace manual profile updates with API calls
    • Automate profile picture synchronization

  2. Pairing Code Auth

    • Update authentication flow to support both QR and pairing code
    • Implement user preference selection

  3. Contact Operations

    • Enhance contact management features
    • Add profile picture display

  4. Chat Management

    • Implement chat organization features
    • Add message moderation capabilities

Deprecation Notices​

Currently Deprecated​

Button Messages (Deprecated May 2022 by WhatsApp)

  • POST /sessions/{id}/send/buttons
  • POST /sessions/{id}/send/interactive
  • POST /sessions/{id}/send/list

Reason: WhatsApp disabled button rendering for unofficial APIs.

Alternative: Use POST /sessions/{id}/send/poll for interactive messages.

Timeline: Endpoints will remain for backward compatibility but buttons won't render.

Support & Feedback​

Version History​

VersionRelease DateEndpointsMajor Features
2.0Feb 202621 newProfile, Pairing Code, Contacts, Chats
1.0Jan 202640+Initial release with core features

Last Updated: February 4, 2026