WA Automate API Reference

REST API for WhatsApp automation. All endpoints require X-API-Key header (if configured).

GET/api/sessionGet session info
GET/api/session/qrGet current QR code
GET/api/session/stateGet session state
GET/api/session/meGet logged-in user info
POST/api/session/startStart session
POST/api/session/stopStop session

POST/api/messages/sendTextSend text message
POST/api/messages/sendImageSend image
POST/api/messages/sendFileSend file
POST/api/messages/sendAudioSend audio
POST/api/messages/sendLocationSend location
POST/api/messages/sendVCardSend contact card
POST/api/messages/sendButtonsSend interactive buttons
POST/api/messages/sendListSend list message
POST/api/messages/sendPollSend poll
POST/api/messages/forwardForward messages
POST/api/messages/reactReact to message
DELETE/api/messages/deleteDelete message
GET/api/messages/{messageId}Get message by ID
GET/api/messages/chat/{chatId}Get chat messages
GET/api/messages/starredGet starred messages
PUT/api/messages/sendSeen?chatId=...Mark chat as seen

GET/api/chatsGet all chats
GET/api/chats/idsGet all chat IDs
GET/api/chats/{chatId}Get single chat
PUT/api/chats/archiveArchive chat
PUT/api/chats/unarchiveUnarchive chat
PUT/api/chats/pinPin chat
PUT/api/chats/unpinUnpin chat
PUT/api/chats/muteMute chat
PUT/api/chats/unmuteUnmute chat
PUT/api/chats/read/{chatId}Mark as read
PUT/api/chats/unread/{chatId}Mark as unread
GET/api/chats/online/{chatId}Check if online
DELETE/api/chats/{chatId}Delete chat

GET/api/contactsGet all contacts
GET/api/contacts/{contactId}Get contact
GET/api/contacts/blockedGet blocked contacts
PUT/api/contacts/block/{contactId}Block contact
PUT/api/contacts/unblock/{contactId}Unblock contact
GET/api/contacts/picture/{contactId}Get profile picture

GET/api/groupsGet all groups
GET/api/groups/{groupId}Get group info
GET/api/groups/{groupId}/membersGet group members
GET/api/groups/{groupId}/adminsGet group admins
GET/api/groups/{groupId}/invite-linkGet invite link
POST/api/groupsCreate group
POST/api/groups/joinJoin group via link
PUT/api/groups/titleSet group title
PUT/api/groups/descriptionSet group description
PUT/api/groups/add-participantAdd participant
PUT/api/groups/remove-participantRemove participant
PUT/api/groups/promotePromote to admin
PUT/api/groups/demoteDemote from admin
PUT/api/groups/leave/{groupId}Leave group

Labels
GET/api/labelsGet all labels
PUT/api/labels/addAdd label to chat
PUT/api/labels/removeRemove label from chat
Status
GET/api/statusGet stories
POST/api/status/textPost text status
DELETE/api/status/{statusId}Delete status
Communities
GET/api/communitiesGet all communities
GET/api/communities/{id}Get community info
Business
GET/api/business/profileGet business profile
GET/api/business/productsGet products