דלג לתוכן הראשי

Full reference

All 70 operations across 10 groups. Identical in Make and n8n.

Instance (5)

Operate your connected number — pair it with a QR code, check the connection state, set presence, restart or log out.

OperationEndpointParameters
Restart Instance
Restart the instance process
restart
POST
/instance/restart/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
Connect Instance
Connect the instance and return its pairing QR code
connect
GET
/instance/connect/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
Get Connection State
Current connection state of the instance
connectionState
GET
/instance/connectionState/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
Set Presence
Set the instance presence, such as available or unavailable
setPresence
POST
/instance/setPresence/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • presence select(unavailable | available | composing | recording | paused) required
Log Out Instance
Log the instance out of WhatsApp without deleting it
logout
DELETE
/instance/logout/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on

Send Message (13)

Every outbound message type: text, media, audio, stickers, locations, contacts, reactions, polls, lists, buttons and Business templates.

OperationEndpointParameters
Send Template
Send an approved WhatsApp Business template
sendTemplate
POST
/message/sendTemplate/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • name text required
  • language text required
  • additionalFields object{ number, components, webhookUrl }
Send Text
Send a plain text message
sendText
POST
/message/sendText/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • number text required
  • text text required
  • quoted object{ id, remoteJid, fromMe, message }
  • additionalFields object{ linkPreview, delay, everyOne, mentioned }
Send Media
Send an image, video or document by URL or base64
sendMedia
POST
/message/sendMedia/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • number text required
  • mediatype select(image | document | video | audio) required
  • quoted object{ id, remoteJid, fromMe, message }
  • additionalFields object{ mimetype, media, fileName, caption, delay, everyOne, mentioned }
Send Video Note
Send a round play-through video note
sendPtv
POST
/message/sendPtv/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • number text required
  • quoted object{ id, remoteJid, fromMe, message }
  • additionalFields object{ video, delay, everyOne, mentioned }
Send Audio
Send a voice note
sendWhatsAppAudio
POST
/message/sendWhatsAppAudio/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • number text required
  • quoted object{ id, remoteJid, fromMe, message }
  • additionalFields object{ audio, delay, everyOne, mentioned }
Send Status
Post a status update to the status feed
sendStatus
POST
/message/sendStatus/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • type select(text | image | audio | video) required
  • additionalFields object{ content, caption, backgroundColor, font, statusJidList, allContacts }
Send Sticker
Send a sticker
sendSticker
POST
/message/sendSticker/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • number text required
  • quoted object{ id, remoteJid, fromMe, message }
  • additionalFields object{ sticker, delay, everyOne, mentioned }
Send Location
Send a geographic location
sendLocation
POST
/message/sendLocation/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • number text required
  • latitude number required
  • longitude number required
  • name text required
  • address text required
  • quoted object{ id, remoteJid, fromMe, message }
  • additionalFields object{ delay, everyOne, mentioned }
Send Contact
Send one or more contact cards
sendContact
POST
/message/sendContact/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • number text required
  • contact array<{ fullName, wuid, phoneNumber, organization, email, url }> required
Send Reaction
React to a message with an emoji
sendReaction
POST
/message/sendReaction/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • key object{ id, remoteJid, fromMe } required
  • reaction text required
Send Poll
Send a poll with selectable options
sendPoll
POST
/message/sendPoll/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • number text required
  • name text required
  • selectableCount integer required
  • values array<text> required
  • quoted object{ id, remoteJid, fromMe, message }
  • additionalFields object{ delay, everyOne, mentioned }
Send List
Send an interactive list menu
sendList
POST
/message/sendList/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • number text required
  • title text required
  • footerText text required
  • buttonText text required
  • sections array<{ title, rows }> required
  • quoted object{ id, remoteJid, fromMe, message }
  • additionalFields object{ description, delay, everyOne, mentioned }
Send Buttons
Send a message with interactive buttons
sendButtons
POST
/message/sendButtons/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • number text required
  • quoted object{ id, remoteJid, fromMe, message }
  • additionalFields object{ thumbnailUrl, title, description, footer, buttons, delay, everyOne, mentioned }

Call (1)

Ring a contact with a call offer.

OperationEndpointParameters
Offer Call
Ring a contact with a call offer
offer
POST
/call/offer/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • number text required
  • callDuration integer required
  • additionalFields object{ isVideo }

Chat (23)

Read and act on conversations — find chats, contacts and messages, mark as read, archive, block, and manage the profile.

OperationEndpointParameters
Check WhatsApp Numbers
Check which of the given numbers are registered on WhatsApp
whatsappNumbers
POST
/chat/whatsappNumbers/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • additionalFields object{ numbers }
Mark Message as Read
Mark one or more messages as read
markMessageAsRead
POST
/chat/markMessageAsRead/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • readMessages array<{ id, fromMe, remoteJid }> required
Archive Chat
Archive or unarchive a chat
archiveChat
POST
/chat/archiveChat/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • lastMessage object{ id, remoteJid, fromMe, messageTimestamp }
  • archive boolean required
  • additionalFields object{ chat }
Mark Chat as Unread
Mark a chat as unread
markChatUnread
POST
/chat/markChatUnread/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • lastMessage object{ id, remoteJid, fromMe, messageTimestamp } required
  • additionalFields object{ chat }
Delete Message for Everyone
Revoke a sent message for all participants
deleteMessageForEveryone
DELETE
/chat/deleteMessageForEveryone/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • id text required
  • fromMe boolean required
  • remoteJid text required
  • additionalFields object{ participant }
Get Profile Picture URL
Profile picture URL for a contact
fetchProfilePictureUrl
POST
/chat/fetchProfilePictureUrl/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • additionalFields object{ number, picture }
Download Media
Download a media message and return it as base64
getBase64FromMediaMessage
POST
/chat/getBase64FromMediaMessage/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • message text required
    The full message object, as returned by Find Messages
  • options object{ convertToMp4 }
Update Message
Edit the text of a message already sent
updateMessage
POST
/chat/updateMessage/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • key object{ id, remoteJid, fromMe }
  • additionalFields object{ number, text }
Send Chat Presence
Show a typing or recording indicator in a chat
sendPresence
POST
/chat/sendPresence/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • number text required
  • delay number required
  • presence select(unavailable | available | composing | recording | paused) required
Update Block Status
Block or unblock a contact
updateBlockStatus
POST
/chat/updateBlockStatus/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • number text required
  • status select(block | unblock) required
Find Contacts
Search stored contacts
findContacts · returns a list
POST
/chat/findContacts/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • where object{ _id, pushName, id, remoteJid }
Find Messages
Search stored messages
findMessages · returns a list
POST
/chat/findMessages/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • where object{ _id, key, message }
  • additionalFields object{ limit }
Find Status Messages
Search status-feed messages
findStatusMessage · returns a list
POST
/chat/findStatusMessage/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • where object{ _id, remoteJid, id, fromMe, participant, status }
  • additionalFields object{ limit }
Find Chats
List stored chats
findChats · returns a list
POST
/chat/findChats/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • where object{ _id, pushName, id, remoteJid }
Get Chat by JID
Fetch one chat by its remote JID
findChatByRemoteJid
GET
/chat/findChatByRemoteJid/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • remoteJid text required
    Chat JID, for example 972500000000@s.whatsapp.net
Get Business Profile
Business profile of a WhatsApp Business contact
fetchBusinessProfile
POST
/chat/fetchBusinessProfile/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • additionalFields object{ number, picture }
Get Profile
Profile details of a contact
fetchProfile
POST
/chat/fetchProfile/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • additionalFields object{ wuid, name, picture, status, isBusiness }
Update Profile Name
Change the instance display name
updateProfileName
POST
/chat/updateProfileName/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • additionalFields object{ name }
Update Profile Status
Change the instance status text
updateProfileStatus
POST
/chat/updateProfileStatus/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • additionalFields object{ status }
Update Profile Picture
Change the instance profile picture
updateProfilePicture
POST
/chat/updateProfilePicture/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • additionalFields object{ number, picture }
Remove Profile Picture
Remove the instance profile picture
removeProfilePicture
DELETE
/chat/removeProfilePicture/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • additionalFields object{ number, picture }
Get Privacy Settings
Current privacy settings for the instance
fetchPrivacySettings
GET
/chat/fetchPrivacySettings/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
Update Privacy Settings
Change the instance privacy settings
updatePrivacySettings
POST
/chat/updatePrivacySettings/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • readreceipts select(all | none) required
  • profile select(all | contacts | contact_blacklist | none) required
  • status select(all | contacts | contact_blacklist | none) required
  • online select(all | match_last_seen) required
  • last select(all | contacts | contact_blacklist | none) required
  • groupadd select(all | contacts | contact_blacklist | none) required

Business (2)

Read a WhatsApp Business product catalog and its collections.

OperationEndpointParameters
Get Catalog
Product catalog of a WhatsApp Business account
getCatalog
POST
/business/getCatalog/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • additionalFields object{ number, limit }
Get Collections
Catalog collections of a WhatsApp Business account
getCollections
POST
/business/getCollections/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • additionalFields object{ number, limit }

Group (16)

Create groups and administer them: participants, invites, subject and picture, and disappearing messages.

OperationEndpointParameters
Create Group
Create a group and add the given participants
createGroup
POST
/group/create/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • subject text required
  • participants array<text> required
  • additionalFields object{ description, profilePicture, promoteParticipants }
Update Group Subject
Rename a group
updateGroupSubject
POST
/group/updateGroupSubject/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • groupJid select · live list required
  • subject text required
Update Group Picture
Change a group picture
updateGroupPicture
POST
/group/updateGroupPicture/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • groupJid select · live list required
  • image text required
Update Group Description
Change a group description
updateGroupDescription
POST
/group/updateGroupDescription/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • groupJid select · live list required
  • description text required
Get Group Info
Metadata for one group
findGroupInfos
GET
/group/findGroupInfos/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • groupJid select · live list required
List Groups
List every group the instance belongs to
fetchAllGroups · returns a list
GET
/group/fetchAllGroups/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • getParticipants select(true | false) required
List Group Participants
List the members of a group
participants · returns a list
GET
/group/participants/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • groupJid select · live list required
Get Group Invite Code
Current invite code for a group
inviteCode
GET
/group/inviteCode/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • groupJid select · live list required
Get Group Invite Info
Inspect a group invite before accepting it
inviteInfo
GET
/group/inviteInfo/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • inviteCode text required
Accept Group Invite
Join a group using an invite code
acceptInviteCode
GET
/group/acceptInviteCode/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • inviteCode text required
Send Group Invite
Send a group invite link to numbers
sendInvite
POST
/group/sendInvite/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • groupJid select · live list required
  • description text required
  • numbers array<text> required
Revoke Group Invite Code
Invalidate the current invite code and issue a new one
revokeInviteCode
POST
/group/revokeInviteCode/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • groupJid select · live list required
Update Group Participant
Add, remove, promote or demote group members
updateParticipant
POST
/group/updateParticipant/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • groupJid select · live list required
  • groupAction select(add | remove | promote | demote) required sends as action
  • participants array<text> required
Update Group Setting
Change who may post or edit group info
updateSetting
POST
/group/updateSetting/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • groupJid select · live list required
  • groupAction select(announcement | not_announcement | locked | unlocked) required sends as action
Toggle Disappearing Messages
Set the disappearing-message timer for a group
toggleEphemeral
POST
/group/toggleEphemeral/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • groupJid select · live list required
  • expiration select(0 | 86400 | 604800 | 7776000) required
Leave Group
Leave a group
leaveGroup
DELETE
/group/leaveGroup/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • groupJid select · live list required

Template (4)

WhatsApp Business message templates — create, edit, delete and list.

OperationEndpointParameters
Create Template
Create a WhatsApp Business message template
createTemplate
POST
/template/create/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • name text required
  • category select(AUTHENTICATION | MARKETING | UTILITY) required
  • language text required
  • components text required
  • additionalFields object{ allowCategoryChange, webhookUrl }
Edit Template
Edit an existing message template
editTemplate
POST
/template/edit/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • templateId text required
  • additionalFields object{ category, allowCategoryChange, ttl, components }
Delete Template
Delete a message template
deleteTemplate
DELETE
/template/delete/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • name text required
  • additionalFields object{ hsmId }
List Templates
List the message templates on the account
findTemplate · returns a list
GET
/template/find/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on

Setting (2)

Instance behaviour — call rejection, read receipts, group handling and history sync.

OperationEndpointParameters
Set Setting
POST /settings/set/{instance}
setSetting
POST
/settings/set/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • rejectCall boolean required
  • groupsIgnore boolean required
  • alwaysOnline boolean required
  • readMessages boolean required
  • readStatus boolean required
  • syncFullHistory boolean required
  • additionalFields object{ msgCall, wavoipToken }
Find Setting
GET /settings/find/{instance}
findSetting · returns a list
GET
/settings/find/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on

Proxy (2)

Route an instance through an HTTP proxy.

OperationEndpointParameters
Set Proxy
Route the instance through an HTTP proxy
setProxy
POST
/proxy/set/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • enabled boolean required
  • host text required
  • port text required
  • protocol text required
  • additionalFields object{ username, password }
Get Proxy
Current proxy configuration
findProxy
GET
/proxy/find/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on

Label (2)

List the chat labels on the account, and attach or detach them.

OperationEndpointParameters
List Labels
List the chat labels defined on the account
findLabels · returns a list
GET
/label/findLabels/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
Add or Remove Label
Attach a label to a chat or remove it
handleLabel
POST
/label/handleLabel/{instance}
  • instance select · live list required
    The Evolution instance (WhatsApp connection) to act on
  • number text required
  • labelId text required
  • labelAction select(add | remove) required sends as action
בואו נתחיל