WhatsApp
Commands
Find every WhatsApp CLI command, option and exit code in the generated reference.
Choose the reference for your task. Start with First tasks if you're getting acquainted; use this reference for exact commands, arguments and options. First tasks →
Personal accountYour WhatsApp chats, messages, contacts, search, files, polls and explicit sends.
BotsWhatsApp Business numbers through Meta’s Cloud API: tokens, messages, approved templates and webhooks.
Group and channel administrationGroup members, invitations, settings, moderation and statistics. Changes require the relevant permissions.
Setup and maintenanceLogin, profiles, configuration, the background server, the local store, diagnostics, agent connection and updates.
Find a command by name
- wa session
- wa session start
- wa session end
- wa setup
- wa account
- wa account list
- wa account show
- wa account update
- wa account sessions
- wa account sessions list
- wa account privacy
- wa account privacy show
- wa account privacy set
- wa chats
- wa chats list
- wa chats events
- wa chats inspect
- wa chats show
- wa chats documents
- wa chats documents list
- wa chats members
- wa chats members list
- wa chats members check
- wa chats members history
- wa chats members fetch
- wa chats members add
- wa chats members remove
- wa chats mark-read
- wa chats tracking
- wa chats tracking list
- wa chats tracking show
- wa chats tracking add
- wa chats tracking remove
- wa chats create
- wa chats join
- wa chats leave
- wa chats update
- wa chats links
- wa chats links show
- wa chats links reset
- wa chats requests
- wa chats requests list
- wa chats requests confirm
- wa chats requests reject
- wa chats admins
- wa chats admins add
- wa chats admins remove
- wa chats folders
- wa chats folders list
- wa chats folders show
- wa chats folders create
- wa chats folders update
- wa chats folders delete
- wa chats rules
- wa chats rules show
- wa chats rules set
- wa chats rules unset
- wa chats moderate
- wa chats mute
- wa chats unmute
- wa chats archive
- wa chats unarchive
- wa chats pin
- wa chats unpin
- wa chats mark-unread
- wa chats delete
- wa chats clear
- wa contacts
- wa contacts list
- wa contacts show
- wa contacts info
- wa contacts context
- wa contacts prepare
- wa contacts events
- wa contacts check
- wa contacts link
- wa contacts unlink
- wa contacts lookup
- wa contacts sync
- wa contacts aliases
- wa contacts aliases set
- wa contacts aliases remove
- wa contacts notes
- wa contacts notes list
- wa contacts notes show
- wa contacts notes add
- wa contacts notes edit
- wa contacts notes remove
- wa contacts add
- wa contacts block
- wa contacts unblock
- wa contacts rename
- wa contacts import
- wa messages
- wa messages evidence
- wa messages list
- wa messages send
- wa messages show
- wa messages context
- wa messages download
- wa messages transcribe
- wa messages edit
- wa messages delete
- wa messages forward
- wa messages pin
- wa messages unpin
- wa messages star
- wa messages unstar
- wa messages link
- wa messages comments
- wa messages links
- wa messages sync
- wa reactions
- wa reactions add
- wa reactions remove
- wa polls
- wa polls show
- wa polls voters
- wa polls vote
- wa polls create
- wa models
- wa models keys
- wa models keys set
- wa models keys remove
- wa models list
- wa models download
- wa inbox
- wa review
- wa watch
- wa serve
- wa server
- wa server start
- wa server stop
- wa server restart
- wa server status
- wa server logs
- wa server install
- wa server uninstall
- wa store
- wa store status
- wa store gaps
- wa store gaps show
- wa store gaps repair
- wa store jobs
- wa store jobs list
- wa store jobs show
- wa store jobs cancel
- wa store jobs retry
- wa store jobs clear
- wa store export
- wa store clear
- wa store info
- wa store check
- wa store migrate
- wa store rebuild
- wa store backup
- wa store restore
- wa store decrypt
- wa store repair
- wa store reset
- wa store copies
- wa store copies delete
- wa conversations
- wa conversations list
- wa conversations show
- wa conversations related
- wa conversations status
- wa conversations batches
- wa conversations batches status
- wa conversations batches show
- wa conversations links
- wa conversations links rebuild
- wa conversations links add
- wa conversations links clear
- wa conversations embeddings
- wa conversations embeddings status
- wa conversations embeddings clear
- wa conversations rebuild
- wa conversations consents
- wa conversations consents list
- wa conversations consents remove
- wa conversations embed
- wa attachments
- wa attachments extract
- wa attachments list
- wa attachments show
- wa attachments update
- wa attachments download
- wa attachments check
- wa attachments jobs
- wa attachments jobs install
- wa attachments jobs start
- wa attachments jobs stop
- wa attachments jobs status
- wa attachments jobs uninstall
- wa attachments move
- wa tags
- wa tags rebuild
- wa tags add
- wa tags remove
- wa tags list
- wa mentions
- wa mentions list
- wa mentions domains
- wa mentions places
- wa mentions show
- wa mentions confirm
- wa mentions reject
- wa mentions rebuild
- wa images
- wa images embed
- wa images models
- wa images models list
- wa images models download
- wa metadata
- wa metadata show
- wa metadata sync
- wa stats
- wa stats messages
- wa stats messages show
- wa stats messages counters
- wa stats messages counters show
- wa stats messages counters sync
- wa stats messages unanswered
- wa stats messages discussion
- wa stats messages top
- wa stats messages evidence
- wa stats contacts
- wa stats contacts responses
- wa stats contacts top
- wa stats contacts evidence
- wa stats chats
- wa stats chats show
- wa stats chats newcomers
- wa stats chats retention
- wa stats tasks
- wa stats tasks show
- wa stats charts
- wa tasks
- wa tasks list
- wa tasks add
- wa tasks update
- wa tasks link
- wa tasks show
- wa tasks related
- wa tasks duplicates
- wa tasks duplicates list
- wa tasks duplicates reject
- wa tasks duplicates defer
- wa tasks merge
- wa tasks unmerge
- wa tasks agenda
- wa tasks categories
- wa tasks scan
- wa tasks claim
- wa tasks release
- wa tasks close
- wa tasks reject
- wa search
- wa search all
- wa search messages
- wa search notes
- wa search conversations
- wa search runs
- wa searches
- wa searches create
- wa searches show
- wa searches list
- wa searches history
- wa searches delete
- wa searches clear
- wa flood
- wa flood clear
- wa recipients
- wa recipients list
- wa recipients add
- wa recipients remove
- wa recipients clear
- wa sends
- wa sends list
- wa runs
- wa runs list
- wa runs show
- wa runs path
- wa config
- wa config show
- wa config set
- wa config unset
- wa doctor
- wa doctor reports
- wa doctor reports show
- wa doctor reports create
- wa commands
- wa commands info
- wa complete
- wa upgrade
- wa mcp
- wa mcp config
- wa mcp add
- wa mcp check
- wa bot
- wa bot auth
- wa bot auth set
- wa bot auth show
- wa bot auth remove
- wa bot list
- wa bot chats
- wa bot chats list
- wa bot chats show
- wa bot chats leave
- wa bot chats action
- wa bot chats admins
- wa bot chats admins list
- wa bot chats admins add
- wa bot chats admins remove
- wa bot chats members
- wa bot chats members remove
- wa bot chats rules
- wa bot chats rules show
- wa bot chats rules set
- wa bot chats rules unset
- wa bot chats moderate
- wa bot messages
- wa bot messages send
- wa bot messages list
- wa bot messages show
- wa bot messages edit
- wa bot messages delete
- wa bot messages pin
- wa bot messages unpin
- wa bot messages between
- wa bot search
- wa bot search messages
- wa bot recipients
- wa bot recipients list
- wa bot recipients add
- wa bot recipients remove
- wa bot recipients clear
- wa bot sends
- wa bot sends list
- wa bot watch
- wa bot callbacks
- wa bot callbacks answer
- wa bot commands
- wa bot commands list
- wa bot commands set
- wa bot commands clear
- wa bot webhooks
- wa bot webhooks list
- wa bot webhooks set
- wa bot webhooks delete
- wa bot contacts
- wa bot contacts show
- wa bot me
- wa bot mcp
- wa bot mcp config
- wa bot api
- wa bot api add-phone-numbers
- wa bot api get-business-portfolio
- wa bot api get-owned-whats-app-business-accounts
- wa bot api get-blocked-users
- wa bot api block-users
- wa bot api unblock-users
- wa bot api check-call-permissions
- wa bot api manage-calls
- wa bot api send-marketing-message
- wa bot api upload-media
- wa bot api send-message
- wa bot api list-qr-codes
- wa bot api create-or-update-qr-code
- wa bot api get-qr-code
- wa bot api delete-qr-code
- wa bot api send-encrypted-message
- wa bot api get-official-business-account-status
- wa bot api request-official-business-account
- wa bot api get-phone-number
- wa bot api update-phone-number
- wa bot api deregister-phone-number
- wa bot api get-message-history
- wa bot api register-phone-number
- wa bot api request-verification-code
- wa bot api get-phone-number-settings
- wa bot api update-phone-number-settings
- wa bot api verify-phone-number-code
- wa bot api get-encryption-public-key
- wa bot api set-encryption-public-key
- wa bot api get-business-profile
- wa bot api update-business-profile
- wa bot api get-commerce-settings
- wa bot api set-commerce-settings
- wa bot api get-business-compliance-info
- wa bot api update-business-compliance-info
- wa bot api get-media
- wa bot api delete-media
- wa bot api get-message-history-events
- wa bot api get-assigned-whats-app-business-accounts
- wa bot api get-whats-app-account-number-details
- wa bot api get-assigned-users
- wa bot api add-assigned-user
- wa bot api remove-assigned-user
- wa bot api configure-conversational-automation
- wa bot api get-credit-lines
- wa bot api list-phone-numbers
- wa bot api create-phone-number
- wa bot api list-schedules
- wa bot api create-schedule
- wa bot api list-subscribed-apps
- wa bot api subscribe-app
- wa bot api unsubscribe-app
- wa bot api get-template
- wa bot api edit-template
- wa bot api list-templates
- wa bot api create-template
- wa bot api delete-template
- wa bot api list-activities
- wa bot api get-business-account
- wa bot api update-business-account
- wa bot api get-business-bot
- wa bot api get-business-profile-by-id
- wa bot api update-business-profile-by-id
- wa bot templates
- wa bot templates list
- wa bot templates send
- wa bot media
- wa bot media download
- wa skill
- wa skill show
- wa skill install
How commands work
wa [profile] [options] <resource> <action> [arguments]- Resource first, then the action. The resource is what you work with:
chats,messages,contacts. The action is what you do with it:list,show,send. - Name the profile as the first word:
wa work chats listlists the chats of profilework. No profile is ever assumed: a command that needs an account and gets none from the first word orWA_PROFILEstops and lists your profiles, even when there is only one. - Global options work with every command:
--jsonfor scripts and agents,--dry-runto check a command without running it,--offlineto answer from the local copy only. - A command that changes something is marked in the reference: “Changes something in WhatsApp” changes data in the messenger, “Changes something on this computer only” changes only files on this computer.
- Permission levels can make a write ask for confirmation first.
--yesgives that confirmation in advance. - Each reference ends with the exit codes.
wa commandslists every command by section and marks the ones that change something. Options are inwa commands --jsonandwa <command> --help. - The shared reference includes paths WhatsApp cannot run. Those commands stop with exit code 2 before any account action; check the personal-account guide’s current limitations.