---
updatedAt: 2026-06-25T19:32:13.000Z
---

# Delete Subscription

Delete an existing webhook subscription by ID. After deletion, the subscription cannot be retrieved.

[block:html]
{
  "html": "<a\n  href=\"https://god.gw.postman.com/run-collection/34477757-98fc9011-a902-4dc8-a8ec-16dba61d263f?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D34477757-98fc9011-a902-4dc8-a8ec-16dba61d263f%26entityType%3Dcollection%26workspaceId%3De352a845-5a81-4cbe-9122-9b33bac31bf3\"\n  target=\"_blank\"\n  style=\"text-decoration: none\"\n>\n  <button>\n    <img\n      src=\"https://run.pstmn.io/button.svg\"\n      alt=\"Run In Postman\"\n      style=\"width: 128px; height: 32px\"\n    />\n  </button>\n</a>"
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Notifications Management",
    "version": "1.0",
    "description": "Notifications Management API"
  },
  "x-readme": {
    "samples-languages": [
      "shell"
    ],
    "proxy-enabled": false
  },
  "servers": [
    {
      "url": "https://marketplace.walmartapis.com",
      "description": "Production URL"
    },
    {
      "url": "https://sandbox.walmartapis.com",
      "description": "Sandbox URL"
    }
  ],
  "security": [
    {
      "basicScheme": []
    }
  ],
  "paths": {
    "/v3/webhooks/subscriptions/{subscriptionId}": {
      "delete": {
        "tags": [
          "Notifications"
        ],
        "summary": "Delete Subscription",
        "description": "Delete an existing webhook subscription by ID. After deletion, the subscription cannot be retrieved.",
        "operationId": "deleteSubscription",
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "description": "Unique identifier of the subscription to delete.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "WM_SEC.ACCESS_TOKEN",
            "description": "Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....."
          },
          {
            "in": "header",
            "name": "WM_CONSUMER.CHANNEL.TYPE",
            "description": "A unique ID to identify the consumer request by channel. Use the Consumer Channel Type received during onboarding.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "WM_QOS.CORRELATION_ID",
            "description": "A unique ID that identifies each API call and is used to track and debug issues. Use a randomly generated GUID for this ID.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "b3261d2d-028a-4ef7-8602-633c23200af6"
          },
          {
            "in": "header",
            "name": "WM_SVC.NAME",
            "description": "Name of the Walmart service being called.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Walmart Marketplace"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Operation",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "subscriptionId": {
                      "type": "string",
                      "description": "Unique identifier of the deleted subscription."
                    },
                    "message": {
                      "type": "string",
                      "description": "Confirmation message indicating the subscription was deleted."
                    }
                  }
                },
                "example": {
                  "subscriptionId": "subscriptionId",
                  "message": "Successfully deleted subscription"
                }
              }
            }
          }
        }
      }
    }
  }
}
```