Disconnect / Log Out a Session
View All WhatsApp Messaging API APIs →Disconnect and remove a session. By default it only drops the live connection while keeping the saved credentials, so the account can be restored later. Pass logout=true to fully log out of WhatsApp, delete the local credentials, and unbind the proxy — after which the account must scan or pair again to reconnect.
API Features
Graceful disconnect Drops the connection but preserves credentials for a later restore
Full logout option logout=true wipes credentials and unbinds the proxy for a clean removal
Lifecycle control Programmatically retire sessions you no longer need
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
DELETE
/api/project/whatsapp-messaging/disconnect-session API Response (JSON)
{} Query Result
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Use Cases
- Deprovision a customer's linked account on churn
- Rotate credentials by logging out and re-linking
- Clean up idle sessions in a multi-tenant deployment