Delete Product

Endpoint

DELETE https://api.gumroad.com/v2/products/:id

Delete a product. This marks the product as deleted and schedules it for permanent deletion.

Authentication

Requires OAuth scope: edit_products

Path Parameters

string

required

The product’s external ID or unique permalink

Response

boolean

required

Whether the deletion was successful

string

Confirmation message when successful

Deletion Process

When a product is deleted:

The product is marked as deleted immediately
Active subscriptions are cancelled (scheduled for 10 minutes)
Product files are scheduled for deletion (10 minutes)
Product rich content is scheduled for deletion (10 minutes)
Product file archives are scheduled for deletion (10 minutes)
Custom domain (if any) is marked as deleted
Public files are scheduled for deletion (10 minutes)
Wishlist entries are scheduled for deletion (10 minutes)

This is a soft delete operation. The product data is not immediately removed, but scheduled for cleanup. Active subscriptions will be automatically cancelled.

Example Request

curl -X DELETE "https://api.gumroad.com/v2/products/kUxDaJMg5NP9PpHRCNYCrw==" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch('https://api.gumroad.com/v2/products/kUxDaJMg5NP9PpHRCNYCrw==', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
  }
});

const data = await response.json();

import requests

response = requests.delete(
    'https://api.gumroad.com/v2/products/kUxDaJMg5NP9PpHRCNYCrw==',
    headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
)

data = response.json()

Example Response

{
  "success": true,
  "message": "The product was deleted successfully."
}

Error Responses

boolean

false when the request fails

string

Error description

Product Not Found

{
  "success": false,
  "message": "The product was not found."
}

Unauthorized

{
  "success": false,
  "message": "Unauthorized"
}

Deletion Failed

{
  "success": false,
  "message": "The product was unable to be modified."
}

Deleting a product will automatically cancel all active subscriptions associated with it. Customers will receive cancellation notifications.

Getting Started

Products

Sales

Licenses

Subscribers

Other Resources

Endpoint

Authentication

Path Parameters

Response

Deletion Process

Example Request

Example Response

Error Responses

Product Not Found

Unauthorized

Deletion Failed

​Endpoint

​Authentication

​Path Parameters

​Response

​Deletion Process

​Example Request

​Example Response

​Error Responses

​Product Not Found

​Unauthorized

​Deletion Failed

Endpoint

Authentication

Path Parameters

Response

Deletion Process

Example Request

Example Response

Error Responses

Product Not Found

Unauthorized

Deletion Failed