Skip to main content
GET
/
webhooks
List Webhooks
curl --request GET \
  --url https://app.wachat.net/api/v1/webhooks \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "count": 1,
  "webhooks": [
    {
      "id": 12,
      "name": "Production webhook",
      "url": "https://example.com/wachat/webhook",
      "events": [
        "messages.upsert",
        "connection.update"
      ],
      "enabled": true,
      "secret": "whsec_••••abcdef",
      "instance": {
        "instanceName": "jakarta_store",
        "displayName": "jakarta_store",
        "apiInstanceName": "t1_mq9r2jov_jakarta_store",
        "internalName": "t1_mq9r2jov_jakarta_store"
      },
      "createdAt": "2026-06-13T08:00:00.000Z",
      "updatedAt": "2026-06-13T08:00:00.000Z"
    }
  ]
}
Return webhook endpoints configured for your Wachat account. Use instanceName only when you want to filter webhooks for one specific apiInstanceName. 
curl "https://app.wachat.net/api/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://app.wachat.net/api/v1/webhooks?instanceName=t1_mq9r2jov_jakarta_store" \
  -H "Authorization: Bearer YOUR_API_KEY"
Webhook secrets are masked in list responses. The full secret is returned when creating or updating a webhook.

Authorizations

​
Authorization
string
header
required

Authenticate your integration payloads by injecting your premium secure Wachat Account API Private Secret Key inside standard Authorization Bearer header vectors.

Query Parameters

​
instanceName
string

Optional API instance name to filter webhooks by instance.

Response

Webhooks returned successfully.

​
success
boolean
Example:

true

​
count
integer
Example:

1

​
webhooks
object[]