Skip to main content
PUT
CLI
Only the fields you send change.

Use Cases

  • Pause delivery: { "status": "inactive" }, resume with { "status": "active" }
  • Rotate the secret: { "secret": "<new secret, at least 16 characters>" }
  • Move your bot: { "url": "https://new-host.example.com/minimo/webhook" }
When no active webhook for whatsapp.message.received is left (paused, or the event removed), your WhatsApp numbers go back to the inbox: nobody answers automatically until you turn the AI assistant on again in Minimo or reactivate the webhook.

Permissions

The API key needs the WhatsApp permission.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
integer
required

The webhook id from Register Webhook or List Webhooks.

Body

application/json
name
string

A label for you.

Minimum string length: 1
url
string

Your HTTPS endpoint that receives the events.

secret
string

A new signing secret (rotation).

Minimum string length: 16
events
enum<string>[]

whatsapp.message.received = a contact wrote to you. whatsapp.message.status = a message you sent was sent, delivered, read or failed.

Minimum array length: 1
Available options:
whatsapp.message.received,
whatsapp.message.status
method
enum<string>
default:POST
Available options:
POST,
GET
headers
object[]

Replaces the static headers.

status
enum<string>

Pause (inactive) or resume (active) delivery without deleting the webhook.

Available options:
active,
inactive

Response

The updated webhook

data
object

A webhook registration. The secret is never returned: hasSecret tells you one is set.