# Gumroad

Your Toolhouse AI Worker can connect to Gumroad using 7 specialized tools.

## Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=gumroad).

## Tools (7)

### `Gumroad Get Resource Subscriptions`

**Integration name:** `GUMROAD_GET_RESOURCE_SUBSCRIPTIONS`

Tool to show all active subscriptions of the user for the input resource. Use when you need to review existing webhooks before adding a new one.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example  | Description                                                                             |
| --------------- | ------ | :------: | -------- | --------------------------------------------------------------------------------------- |
| `resource_name` | string |     ✅    | `"sale"` | Name of the resource to list subscriptions for. One of the eight supported event types. |

***

### `Gumroad Get Sales`

**Integration name:** `GUMROAD_GET_SALES`

Tool to retrieve all successful sales by the authenticated user; excludes failed charges, abandoned carts, and page views — conversion rates cannot be derived from this data. Use when you need to list your Gumroad sales, optionally filtering by email, date range, product, or pagination. For high sales volumes, combine `product_id` and/or `after`/`before` filters with `page` to avoid large unfiltered result sets.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                  | Description                                                                     |
| ------------ | ------- | :------: | ------------------------ | ------------------------------------------------------------------------------- |
| `page`       | integer |          | `1`                      | Page number for paginated results; minimum is 1.                                |
| `after`      | string  |          | —                        | Only include sales after this ISO8601 date/time (e.g., '2023-01-01T00:00:00Z'). |
| `email`      | string  |          | `"customer@example.com"` | Filter sales by customer email address.                                         |
| `before`     | string  |          | —                        | Only include sales before this ISO8601 date/time.                               |
| `product_id` | string  |          | `"prod_ABC123"`          | Filter sales by a specific product ID.                                          |

***

### `Gumroad Get User`

**Integration name:** `GUMROAD_GET_USER`

Tool to retrieve the authenticated user's data. Use when you need the current user's profile details after authentication.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Gumroad List Products`

**Integration name:** `GUMROAD_LIST_PRODUCTS`

Tool to retrieve all products for the authenticated Gumroad account. Use when you need product IDs for downstream operations like license verification, subscriber retrieval, or offer-code management.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Gumroad Subscribe To Resource`

**Integration name:** `GUMROAD_SUBSCRIBE_TO_RESOURCE`

Tool to subscribe to a resource. Use when you need to receive real-time event webhooks after creating your webhook endpoint.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example                         | Description                                                   |
| --------------- | ------ | :------: | ------------------------------- | ------------------------------------------------------------- |
| `post_url`      | string |     ✅    | `"https://example.com/webhook"` | Your endpoint URL that will receive HTTP POST notifications.  |
| `resource_name` | string |     ✅    | `"sale"`                        | One of the eight supported Gumroad resources to subscribe to. |

***

### `Gumroad Unsubscribe From Resource`

**Integration name:** `GUMROAD_UNSUBSCRIBE_FROM_RESOURCE`

Tool to unsubscribe from a resource. Use after verifying the subscription ID exists to remove webhook.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                  | Type   | Required | Example                      | Description                                      |
| -------------------------- | ------ | :------: | ---------------------------- | ------------------------------------------------ |
| `resource_subscription_id` | string |     ✅    | `"G_-mnBf9b1j9A7a4ub4nFQ=="` | Unique ID of the resource subscription to delete |

***

### `Gumroad Verify License`

**Integration name:** `GUMROAD_VERIFY_LICENSE`

Tool to verify a Gumroad license key against a specific product. Use when you need to check if a license key is valid, check usage count, or verify membership entitlement for software licensing or gated content.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type    | Required | Example                 | Description                                                                                          |
| ---------------------- | ------- | :------: | ----------------------- | ---------------------------------------------------------------------------------------------------- |
| `product_id`           | string  |     ✅    | `"prod_ABC123"`         | The product ID to verify the license against. Required for products created on or after Jan 9, 2023. |
| `license_key`          | string  |     ✅    | `"ABCD-EFGH-IJKL-MNOP"` | The license key to verify.                                                                           |
| `increment_uses_count` | boolean |          | —                       | Whether to increment the uses count for the license. Defaults to true if not specified.              |

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/integrations/gumroad.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.