> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minimo.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Webhook

> Stop sending events to a webhook

Delivery stops at once. When no active webhook for `whatsapp.message.received` is left, your WhatsApp numbers go back
to the inbox: nobody answers automatically until you turn the AI assistant on again in Minimo.

To stop for a while without deleting, set `status` to `inactive` with [Update
Webhook](https://docs.minimo.it/api-reference/whatsapp-transport/webhook-update.md).

## Permissions

The API key needs the **WhatsApp** permission.


## OpenAPI

````yaml delete /public/v1/webhooks/registrations/{id}
openapi: 3.1.0
info:
  title: API Documentation
  description: Documentation for transactional and subscribe APIs
  version: 1.0.0
servers:
  - url: https://app.minimo.it
security:
  - bearerAuth: []
paths:
  /public/v1/webhooks/registrations/{id}:
    servers:
      - url: https://api.minimo.it
    delete:
      summary: Delete a webhook
      description: >-
        Delivery stops at once. When no active webhook for
        `whatsapp.message.received` is left, the numbers go back to the inbox
        (nobody answers automatically).
      operationId: deleteWebhookRegistration
      parameters:
        - name: id
          in: path
          required: true
          description: The webhook `id` from Register Webhook or List Webhooks.
          schema:
            type: integer
      responses:
        '200':
          description: Deleted
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      success:
                        type: boolean
              example:
                data:
                  success: true
        '401':
          description: >-
            Missing or invalid API key, or a key without the `WhatsApp`
            permission.
        '404':
          description: No webhook with this id in your workspace.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: FAIL
                  message:
                    type: string
      security:
        - bearerAuth: []
      x-codeSamples:
        - label: CLI
          lang: cURL
          source: |-
            curl --request DELETE \
              --url 'https://api.minimo.it/public/v1/webhooks/registrations/42' \
              --header 'Authorization: Bearer {{BEARER_TOKEN}}'
        - lang: JavaScript
          source: >-
            const res = await
            fetch('https://api.minimo.it/public/v1/webhooks/registrations/42', {
              method: 'DELETE',
              headers: {
                'Authorization': 'Bearer {{BEARER_TOKEN}}',
              },
            });

            const { data } = await res.json();

            console.log(data);
        - lang: Python
          source: |-
            import requests

            res = requests.delete(
                'https://api.minimo.it/public/v1/webhooks/registrations/42',
                headers={'Authorization': 'Bearer {{BEARER_TOKEN}}'},
            )
            print(res.json())
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: mn-API_CLIENT_ID-API_KEY

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.