Skip to main content
POST
/
webhook
/
set
/
{instance}
Set Webhook
curl --request POST \
  --url https://{server-url}/webhook/set/{instance} \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "url": "<string>",
  "events": [
    "APPLICATION_STARTUP"
  ],
  "webhook_by_events": true,
  "webhook_base64": true
}
'
{
  "webhook": {
    "instanceName": "teste-docs",
    "webhook": {
      "url": "https://example.com",
      "events": [
        "APPLICATION_STARTUP"
      ],
      "enabled": true
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://doc.evolution-api.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
apikey
string
header
required

Your authorization key header

Path Parameters

​
instance
string
required

ID of the instance to connect

Body

application/json
​
url
string
required

Webhook URL

​
events
enum<string>[]
required

Events to be sent to the Webhook

Minimum array length: 1
Available options:
APPLICATION_STARTUP,
QRCODE_UPDATED,
MESSAGES_SET,
MESSAGES_UPSERT,
MESSAGES_UPDATE,
MESSAGES_DELETE,
SEND_MESSAGE,
CONTACTS_SET,
CONTACTS_UPSERT,
CONTACTS_UPDATE,
PRESENCE_UPDATE,
CHATS_SET,
CHATS_UPSERT,
CHATS_UPDATE,
CHATS_DELETE,
GROUPS_UPSERT,
GROUP_UPDATE,
GROUP_PARTICIPANTS_UPDATE,
CONNECTION_UPDATE,
CALL,
NEW_JWT_TOKEN,
TYPEBOT_START,
TYPEBOT_CHANGE_STATUS
​
webhook_by_events
boolean

Enables Webhook by events

​
webhook_base64
boolean

Sends files in base64 when available

Response

201 - application/json

Created

​
webhook
object