@whop/cli 0.16.0 → 0.16.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/dist/index.js +1534 -412
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
- package/skills/whop/SKILL.md +48 -0
- package/skills/whop/references/ads.md +43 -0
- package/skills/whop/references/formation.md +40 -0
- package/skills/whop/references/websites.md +59 -0
- package/skills/whop-accounts/SKILL.md +0 -228
- package/skills/whop-ad-campaigns/SKILL.md +0 -204
- package/skills/whop-ad-groups/SKILL.md +0 -269
- package/skills/whop-ads/SKILL.md +0 -277
- package/skills/whop-api-keys/SKILL.md +0 -126
- package/skills/whop-app-builds/SKILL.md +0 -81
- package/skills/whop-apps/SKILL.md +0 -161
- package/skills/whop-audiences/SKILL.md +0 -105
- package/skills/whop-bounties/SKILL.md +0 -145
- package/skills/whop-bounty-submissions/SKILL.md +0 -95
- package/skills/whop-cards/SKILL.md +0 -133
- package/skills/whop-checkout-configurations/SKILL.md +0 -77
- package/skills/whop-deposits/SKILL.md +0 -26
- package/skills/whop-dispute-alerts/SKILL.md +0 -42
- package/skills/whop-disputes/SKILL.md +0 -99
- package/skills/whop-events/SKILL.md +0 -105
- package/skills/whop-exports/SKILL.md +0 -379
- package/skills/whop-ledgers/SKILL.md +0 -52
- package/skills/whop-media/SKILL.md +0 -44
- package/skills/whop-members/SKILL.md +0 -64
- package/skills/whop-memberships/SKILL.md +0 -165
- package/skills/whop-notifications/SKILL.md +0 -104
- package/skills/whop-partners/SKILL.md +0 -113
- package/skills/whop-payment-method-domains/SKILL.md +0 -93
- package/skills/whop-payments/SKILL.md +0 -40
- package/skills/whop-payouts/SKILL.md +0 -167
- package/skills/whop-people/SKILL.md +0 -63
- package/skills/whop-permissions/SKILL.md +0 -21
- package/skills/whop-plans/SKILL.md +0 -165
- package/skills/whop-products/SKILL.md +0 -153
- package/skills/whop-recommended-actions/SKILL.md +0 -59
- package/skills/whop-resolution-center-cases/SKILL.md +0 -233
- package/skills/whop-setup-intents/SKILL.md +0 -40
- package/skills/whop-shipments/SKILL.md +0 -79
- package/skills/whop-social-accounts/SKILL.md +0 -128
- package/skills/whop-stats/SKILL.md +0 -65
- package/skills/whop-swaps/SKILL.md +0 -77
- package/skills/whop-team-members/SKILL.md +0 -93
- package/skills/whop-transfers/SKILL.md +0 -80
- package/skills/whop-users/SKILL.md +0 -309
- package/skills/whop-verifications/SKILL.md +0 -67
|
@@ -1,167 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: whop-payouts
|
|
3
|
-
description: Send money from a balance to a bank or wallet. Run `whop payouts --help` for usage details.
|
|
4
|
-
requires_bin: whop
|
|
5
|
-
command: whop payouts
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
Payouts represent money sent from an account or user balance to an external destination, such as a bank account, wallet, or other saved payout method.
|
|
9
|
-
|
|
10
|
-
Use the Payouts API to create and track payouts, manage saved payout methods, and show expected arrival details for funds leaving Whop.
|
|
11
|
-
|
|
12
|
-
# whop payouts create
|
|
13
|
-
|
|
14
|
-
Create Payout
|
|
15
|
-
|
|
16
|
-
## Options
|
|
17
|
-
|
|
18
|
-
| Flag | Type | Required | Default | Description |
|
|
19
|
-
|------|------|----------|---------|-------------|
|
|
20
|
-
| `--account_id` | `string` | no | | Account to pay out from, prefixed `biz_`. Provide exactly one of `account_id` or `user_id`. |
|
|
21
|
-
| `--acknowledge_bank_warning` | `boolean` | no | | Set to `true` to continue when the destination bank could not confirm the payout method account holder's name, or `false` to have the payout refused in that case so the account holder can correct the name or link their bank first. Omitting the field skips the warning gate — a client that cannot show the warning keeps its pre-gate behavior. |
|
|
22
|
-
| `--amount` | `number` | yes | | The amount to pay out in the specified currency. |
|
|
23
|
-
| `--currency` | `string` | no | | The currency to pay out. Balances are held per currency and the payout draws only from the balance in this currency, so match the currency the funds arrived in — for example `cad` for an account funded by CAD transfers. Defaults to `usd`. |
|
|
24
|
-
| `--idempotency_key` | `unknown` | no | | A unique key that makes retries safe. Retrying with the same key returns the original payout instead of paying out twice. Also accepted as the `Idempotency-Key` header. |
|
|
25
|
-
| `--notes` | `unknown` | no | | Free-form notes to attach to the payout, with a maximum of 255 characters. Omit or pass `null` for no notes. |
|
|
26
|
-
| `--payout_method_id` | `string` | yes | | The saved payout method to deliver to (a potk_ identifier). |
|
|
27
|
-
| `--platform_covers_fees` | `boolean` | no | | Whether the parent platform covers the payout fee instead of the account being paid out. Omit to use the platform's configured fee coverage policy; pass `false` to opt out of it. `true` is only accepted for accounts that belong to a platform, and requires the platform's policy to cover this payout method's category or a caller authorized to manage the platform's child account fees. |
|
|
28
|
-
| `--speed` | `string` | no | | How fast the funds should arrive. `instant` is only accepted when the account and payout method are eligible; otherwise the payout is rejected. |
|
|
29
|
-
| `--user_id` | `string` | no | | User to pay out from, prefixed `user_`. Provide exactly one of `account_id` or `user_id`. |
|
|
30
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
31
|
-
|
|
32
|
-
> Confirm with the user before executing this destructive command.
|
|
33
|
-
|
|
34
|
-
---
|
|
35
|
-
|
|
36
|
-
# whop payouts create-method
|
|
37
|
-
|
|
38
|
-
Create Saved Payout Method
|
|
39
|
-
|
|
40
|
-
## Options
|
|
41
|
-
|
|
42
|
-
| Flag | Type | Required | Default | Description |
|
|
43
|
-
|------|------|----------|---------|-------------|
|
|
44
|
-
| `--account_id` | `string` | no | | The account to add the payout method for, prefixed `biz_`. Provide this or `user_id`. |
|
|
45
|
-
| `--destination_currency` | `string` | no | `usd` | Currency the supported payout method delivers payouts in. |
|
|
46
|
-
| `--fields` | `object` | no | | The supported payout method's required field values, keyed by field id — list them with `GET /payouts/supported_methods?supported_payout_method_id=...`. A Basis Theory token id may be passed in place of a raw value. For a U.S. bank routing-number field, a raw nine-digit value must also pass the ABA checksum. A validation failure returns the method's full required_fields schema alongside the error. Required whenever the account details are supplied directly. |
|
|
47
|
-
| `--is_default` | `boolean` | no | `false` | Whether to make this the account's default payout method. |
|
|
48
|
-
| `--nickname` | `string` | no | | A label for the payout method, unique per destination. |
|
|
49
|
-
| `--supported_payout_method_id` | `string` | yes | | The supported payout method to save (a podst_ identifier from a previous listing). |
|
|
50
|
-
| `--user_id` | `string` | no | | The user to add the payout method for, prefixed `user_`. Provide this or `account_id`. |
|
|
51
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
52
|
-
|
|
53
|
-
> Confirm with the user before executing this destructive command.
|
|
54
|
-
|
|
55
|
-
---
|
|
56
|
-
|
|
57
|
-
# whop payouts delete-method
|
|
58
|
-
|
|
59
|
-
Delete Saved Payout Method
|
|
60
|
-
|
|
61
|
-
## Arguments
|
|
62
|
-
|
|
63
|
-
| Name | Type | Required | Description |
|
|
64
|
-
|------|------|----------|-------------|
|
|
65
|
-
| `id` | `string` | yes | Payout method ID, prefixed `potk_`. |
|
|
66
|
-
|
|
67
|
-
> Confirm with the user before executing this destructive command.
|
|
68
|
-
|
|
69
|
-
---
|
|
70
|
-
|
|
71
|
-
# whop payouts get
|
|
72
|
-
|
|
73
|
-
Retrieve Payout
|
|
74
|
-
|
|
75
|
-
## Arguments
|
|
76
|
-
|
|
77
|
-
| Name | Type | Required | Description |
|
|
78
|
-
|------|------|----------|-------------|
|
|
79
|
-
| `id` | `string` | yes | Payout ID, prefixed `wdrl_` for a payout returned by `GET /payouts` or `cofr_` for the payout request returned by `POST /payouts`. |
|
|
80
|
-
|
|
81
|
-
## Options
|
|
82
|
-
|
|
83
|
-
| Flag | Type | Required | Default | Description |
|
|
84
|
-
|------|------|----------|---------|-------------|
|
|
85
|
-
| `--account_id` | `string` | no | | Owning account ID, prefixed `biz_`. Provide exactly one of `account_id` or `user_id`. |
|
|
86
|
-
| `--user_id` | `string` | no | | Owning user ID, prefixed `user_`. Provide exactly one of `account_id` or `user_id`. |
|
|
87
|
-
|
|
88
|
-
---
|
|
89
|
-
|
|
90
|
-
# whop payouts list
|
|
91
|
-
|
|
92
|
-
List Payouts
|
|
93
|
-
|
|
94
|
-
## Options
|
|
95
|
-
|
|
96
|
-
| Flag | Type | Required | Default | Description |
|
|
97
|
-
|------|------|----------|---------|-------------|
|
|
98
|
-
| `--account_id` | `string` | no | | The owning account ID (a biz_ identifier). Provide this or user_id. |
|
|
99
|
-
| `--user_id` | `string` | no | | The owning user ID (a user_ identifier). Provide this or account_id. |
|
|
100
|
-
| `--currency` | `string` | no | | Optional currency code filter, for example `usd`. |
|
|
101
|
-
| `--first` | `number` | no | `20` | Number of payouts to return from the start of the window. |
|
|
102
|
-
| `--after` | `string` | no | | Cursor to fetch the page after (from page_info.end_cursor). |
|
|
103
|
-
| `--last` | `number` | no | | Number of payouts to return from the end of the window. |
|
|
104
|
-
| `--before` | `string` | no | | Cursor to fetch the page before (from page_info.start_cursor). |
|
|
105
|
-
|
|
106
|
-
---
|
|
107
|
-
|
|
108
|
-
# whop payouts methods
|
|
109
|
-
|
|
110
|
-
List Saved Payout Methods
|
|
111
|
-
|
|
112
|
-
## Options
|
|
113
|
-
|
|
114
|
-
| Flag | Type | Required | Default | Description |
|
|
115
|
-
|------|------|----------|---------|-------------|
|
|
116
|
-
| `--account_id` | `string` | no | | The owning account ID (a biz_ identifier). Provide this or user_id. |
|
|
117
|
-
| `--user_id` | `string` | no | | The owning user ID (a user_ identifier). Provide this or account_id. |
|
|
118
|
-
| `--status` | `string` | no | | Optional status filter. `created` means saved but unused, `active` means a payout through it succeeded, `broken` means the last payout failed and the method needs fixing. |
|
|
119
|
-
| `--amount` | `number` | no | | Optional withdrawal amount in whole currency units, for example `250.00`. When provided, each method includes a quote with the estimated fee, amount received, and delivery date for that amount. |
|
|
120
|
-
| `--currency` | `string` | no | `usd` | Currency code of the amount, for example `usd`. Only meaningful with amount or include_limits. |
|
|
121
|
-
| `--include_limits` | `boolean` | no | `false` | When true, the response also carries limits — the live per-speed payout caps the account's payout requests are validated against, in the requested currency. Requires the payout:withdrawal:read scope. |
|
|
122
|
-
| `--first` | `number` | no | `20` | Number of payout methods to return from the start of the window. |
|
|
123
|
-
| `--after` | `string` | no | | Cursor to fetch the page after (from page_info.end_cursor). |
|
|
124
|
-
| `--last` | `number` | no | | Number of payout methods to return from the end of the window. |
|
|
125
|
-
| `--before` | `string` | no | | Cursor to fetch the page before (from page_info.start_cursor). |
|
|
126
|
-
|
|
127
|
-
---
|
|
128
|
-
|
|
129
|
-
# whop payouts supported-methods
|
|
130
|
-
|
|
131
|
-
List Supported Payout Methods
|
|
132
|
-
|
|
133
|
-
## Options
|
|
134
|
-
|
|
135
|
-
| Flag | Type | Required | Default | Description |
|
|
136
|
-
|------|------|----------|---------|-------------|
|
|
137
|
-
| `--account_id` | `string` | no | | The owning account ID (a biz_ identifier). Provide this or user_id. |
|
|
138
|
-
| `--user_id` | `string` | no | | The owning user ID (a user_ identifier). Provide this or account_id. |
|
|
139
|
-
| `--country` | `string` | no | | ISO 3166-1 alpha-2 country code for the bank account or wallet, such as `US`. Defaults to the country of supported_payout_method_id when one is given, otherwise the payout account's country. |
|
|
140
|
-
| `--amount` | `number` | no | | Optional withdrawal amount in whole currency units, for example `250.00`. When provided, each destination includes per-currency fee and delivery quotes. |
|
|
141
|
-
| `--currency` | `string` | no | `usd` | Currency code of the amount, for example `usd`. Only meaningful with amount. |
|
|
142
|
-
| `--supported_payout_method_id` | `string` | no | | Narrows the list to one supported payout method (a podst_ identifier) and includes the required_fields needed to save it as a payout method. |
|
|
143
|
-
| `--destination_currency` | `string` | no | `usd` | Currency the supported payout method would deliver payouts in. Only meaningful with supported_payout_method_id; required fields vary by destination currency. |
|
|
144
|
-
| `--first` | `number` | no | `20` | Number of supported payout methods to return from the start of the window. |
|
|
145
|
-
| `--after` | `string` | no | | Cursor to fetch the page after (from page_info.end_cursor). |
|
|
146
|
-
| `--last` | `number` | no | | Number of supported payout methods to return from the end of the window. |
|
|
147
|
-
| `--before` | `string` | no | | Cursor to fetch the page before (from page_info.start_cursor). |
|
|
148
|
-
|
|
149
|
-
---
|
|
150
|
-
|
|
151
|
-
# whop payouts update-method
|
|
152
|
-
|
|
153
|
-
Rename Saved Payout Method
|
|
154
|
-
|
|
155
|
-
## Arguments
|
|
156
|
-
|
|
157
|
-
| Name | Type | Required | Description |
|
|
158
|
-
|------|------|----------|-------------|
|
|
159
|
-
| `id` | `string` | yes | Payout method ID, prefixed `potk_`. |
|
|
160
|
-
|
|
161
|
-
## Options
|
|
162
|
-
|
|
163
|
-
| Flag | Type | Required | Default | Description |
|
|
164
|
-
|------|------|----------|---------|-------------|
|
|
165
|
-
| `--nickname` | `string` | yes | | New label for the payout method, with at least one non-whitespace character and a maximum of 100 characters. |
|
|
166
|
-
|
|
167
|
-
> Confirm with the user before executing this destructive command.
|
|
@@ -1,63 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: whop-people
|
|
3
|
-
description: Visitors and customers of an account, with identity, purchase, and traffic profiles. Run `whop people --help` for usage details.
|
|
4
|
-
requires_bin: whop
|
|
5
|
-
command: whop people
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
A Person is an identity-linked profile of a visitor or customer of an account, assembled from every [event](https://docs.whop.com/api-reference/beta/events/event) the person generated — pixel page views, ad clicks, leads, identifies, and payments. Each profile carries the person's known identities (names, emails, phones, user IDs), purchase history and LTV, geo/device profile, traffic sources, and the first and last marketing touches that reached them.
|
|
9
|
-
|
|
10
|
-
Use the People API to list and segment the people of an account — filter by activity, purchases, traffic source, location, or marketing touch, and sort by value — or retrieve one person by person ID, user ID, email address, or phone number.
|
|
11
|
-
|
|
12
|
-
# whop people get
|
|
13
|
-
|
|
14
|
-
Retrieve Person
|
|
15
|
-
|
|
16
|
-
## Arguments
|
|
17
|
-
|
|
18
|
-
| Name | Type | Required | Description |
|
|
19
|
-
|------|------|----------|-------------|
|
|
20
|
-
| `id` | `string` | yes | The person ID, user ID, email address, or phone number to look up. |
|
|
21
|
-
|
|
22
|
-
## Options
|
|
23
|
-
|
|
24
|
-
| Flag | Type | Required | Default | Description |
|
|
25
|
-
|------|------|----------|---------|-------------|
|
|
26
|
-
| `--account_id` | `string` | no | | Account ID, prefixed `biz_`. Optional for account API keys; required for credentials that can access multiple accounts. |
|
|
27
|
-
|
|
28
|
-
---
|
|
29
|
-
|
|
30
|
-
# whop people list
|
|
31
|
-
|
|
32
|
-
List People
|
|
33
|
-
|
|
34
|
-
## Options
|
|
35
|
-
|
|
36
|
-
| Flag | Type | Required | Default | Description |
|
|
37
|
-
|------|------|----------|---------|-------------|
|
|
38
|
-
| `--account_id` | `string` | no | | Account ID, prefixed `biz_`. Optional for account API keys; required for credentials that can access multiple accounts. |
|
|
39
|
-
| `--query` | `string` | no | | Search people by name, email, phone, or whop user ID (case-insensitive substring match). |
|
|
40
|
-
| `--source` | `array` | no | | Only include people acquired from any of these sources — canonical paths (whop:<campaign>:<group>:<ad>, ext:<platform>:..., referrer:<domain>, direct, other), exact or with a trailing :* prefix. The same vocabulary the events / people metrics use. |
|
|
41
|
-
| `--attribution_model` | `string` | no | | Attribution model the source filter matches against (defaults to last_touch). |
|
|
42
|
-
| `--event_name` | `array` | no | | Only include people who fired any of these events, e.g. payment.completed or page.checkout.view. |
|
|
43
|
-
| `--custom_event` | `string` | no | | Only include people who fired this custom pixel event. |
|
|
44
|
-
| `--event_from` | `string` | no | | With event_to plus an event or source filter, switches to exact-population mode: person ids are resolved and paginated on the events side within this window (the same query the people metric counts), then hydrated per page. |
|
|
45
|
-
| `--event_to` | `string` | no | | The inclusive end of the event window for exact-population mode. |
|
|
46
|
-
| `--audience_id` | `string` | no | | Only include people in this audience. An audience that keeps itself up to date resolves to the People filters that define it, so this always reflects who matches now; uploaded lists and point-in-time snapshots match their recorded members. |
|
|
47
|
-
| `--user_id` | `string` | no | | Only include the person linked to this whop user ID. |
|
|
48
|
-
| `--email` | `string` | no | | Only include the person linked to this email address. |
|
|
49
|
-
| `--phone` | `string` | no | | Only include the person linked to this phone number. |
|
|
50
|
-
| `--country` | `string` | no | | Only include people whose most recent visit came from this ISO 3166-1 alpha-2 country code. |
|
|
51
|
-
| `--has_purchased` | `boolean` | no | | true for customers only, false for people who have never purchased. |
|
|
52
|
-
| `--contactable` | `boolean` | no | | true for people who have an email address or phone number — the ones an ad platform can match. |
|
|
53
|
-
| `--first_seen_within_days` | `number` | no | | Only include people first seen within this many days, as a rolling window. |
|
|
54
|
-
| `--last_seen_within_days` | `number` | no | | Only include people last seen within this many days, as a rolling window. |
|
|
55
|
-
| `--first_seen_after` | `string` | no | | Only include people first seen at or after this ISO 8601 timestamp. |
|
|
56
|
-
| `--first_seen_before` | `string` | no | | Only include people first seen before this ISO 8601 timestamp. |
|
|
57
|
-
| `--last_seen_after` | `string` | no | | Only include people last seen at or after this ISO 8601 timestamp. |
|
|
58
|
-
| `--last_seen_before` | `string` | no | | Only include people last seen before this ISO 8601 timestamp. |
|
|
59
|
-
| `--first` | `number` | no | | The number of people to return (default 100, max 100). |
|
|
60
|
-
| `--after` | `string` | no | | A cursor for fetching people after a previous page. |
|
|
61
|
-
| `--before` | `string` | no | | A cursor for fetching people before a later page. |
|
|
62
|
-
| `--order` | `string` | no | | Column to sort by. Defaults to last_seen_at. |
|
|
63
|
-
| `--direction` | `string` | no | | Sort direction. Defaults to desc. |
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: whop-permissions
|
|
3
|
-
description: What your credential is allowed to do on a resource. Run `whop permissions --help` for usage details.
|
|
4
|
-
requires_bin: whop
|
|
5
|
-
command: whop permissions
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
A Permission is one action, such as `stats:read`, paired with whether your credential is granted it on a given resource. It answers for whatever you authenticated with, so you can decide what to show or attempt instead of discovering a `403`.
|
|
9
|
-
|
|
10
|
-
Use the Permissions API to check an account, product, experience, or app, narrowing to the actions you care about. It reports only your own access — to manage who else can reach an account, use the Team Members API.
|
|
11
|
-
|
|
12
|
-
# whop permissions check
|
|
13
|
-
|
|
14
|
-
Check Permissions
|
|
15
|
-
|
|
16
|
-
## Options
|
|
17
|
-
|
|
18
|
-
| Flag | Type | Required | Default | Description |
|
|
19
|
-
|------|------|----------|---------|-------------|
|
|
20
|
-
| `--resource_id` | `string` | yes | | Tag of the resource to check against: an account (`biz_`), product (`prod_`), experience (`exp_`), or app (`app_`). A resource the credential cannot see is reported as granted nothing rather than as an error. |
|
|
21
|
-
| `--actions` | `string` | no | | Comma-separated permission actions to check, for example `stats:read,payment:basic:read`. Every action is returned when omitted. |
|
|
@@ -1,165 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: whop-plans
|
|
3
|
-
description: "Pricing for a product: one-time, recurring, trials, stock. Run `whop plans --help` for usage details."
|
|
4
|
-
requires_bin: whop
|
|
5
|
-
command: whop plans
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
A Plan defines how customers buy a product. It controls pricing, billing cadence, availability, tax behavior, checkout fields, and purchase visibility.
|
|
9
|
-
|
|
10
|
-
Use the Plans API to create plans for products, list existing plans, retrieve or update plan configuration, calculate tax for checkout, and delete plans that should no longer be offered.
|
|
11
|
-
|
|
12
|
-
# whop plans calculate_tax
|
|
13
|
-
|
|
14
|
-
Calculate Tax
|
|
15
|
-
|
|
16
|
-
## Arguments
|
|
17
|
-
|
|
18
|
-
| Name | Type | Required | Description |
|
|
19
|
-
|------|------|----------|-------------|
|
|
20
|
-
| `id` | `string` | yes | Plan ID, prefixed `plan_`. |
|
|
21
|
-
|
|
22
|
-
## Options
|
|
23
|
-
|
|
24
|
-
| Flag | Type | Required | Default | Description |
|
|
25
|
-
|------|------|----------|---------|-------------|
|
|
26
|
-
| `--address` | `unknown` | no | | Buyer billing address used for tax calculation. Provide either `address.country` or `ip_address`; include state and postal code when available for more accurate results. |
|
|
27
|
-
| `--ip_address` | `string` | no | | Buyer IP address used to infer location when no billing address is provided. |
|
|
28
|
-
| `--tax_ids` | `unknown` | no | | Optional buyer tax ID for B2B exemptions. At most one entry is supported. |
|
|
29
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
30
|
-
|
|
31
|
-
> Confirm with the user before executing this destructive command.
|
|
32
|
-
|
|
33
|
-
---
|
|
34
|
-
|
|
35
|
-
# whop plans create
|
|
36
|
-
|
|
37
|
-
Create Plan
|
|
38
|
-
|
|
39
|
-
## Options
|
|
40
|
-
|
|
41
|
-
| Flag | Type | Required | Default | Description |
|
|
42
|
-
|------|------|----------|---------|-------------|
|
|
43
|
-
| `--account_id` | `string` | no | | The unique identifier of the account to create this plan for. Defaults to the caller's account. |
|
|
44
|
-
| `--adaptive_pricing_enabled` | `boolean` | no | | Whether this plan accepts local currency payments via adaptive pricing. |
|
|
45
|
-
| `--billing_period` | `number` | no | | Recurring billing interval in days, such as 30 for monthly or 365 for annual. |
|
|
46
|
-
| `--checkout_styling` | `unknown` | no | | Checkout styling overrides for this plan. |
|
|
47
|
-
| `--currency` | `string` | no | | The three-letter ISO currency code for the plan's pricing. Defaults to USD. |
|
|
48
|
-
| `--custom_fields` | `unknown` | no | | An array of custom field definitions to collect from customers at checkout. Omitting this field clears existing custom fields. |
|
|
49
|
-
| `--description` | `unknown` | no | | A text description of the plan displayed to customers on the product page. |
|
|
50
|
-
| `--expiration_days` | `number` | no | | Access duration in days before the membership expires. |
|
|
51
|
-
| `--image` | `unknown` | no | | An image displayed on the product page to represent this plan. |
|
|
52
|
-
| `--initial_price` | `number` | no | | Initial amount charged in the plan's currency, e.g. 10.43 for $10.43. |
|
|
53
|
-
| `--internal_notes` | `unknown` | no | | Private notes visible only to the account owner. Not shown to customers. |
|
|
54
|
-
| `--metadata` | `unknown` | no | | Custom key-value pairs to store on the plan. Included in webhook payloads for payment and membership events. Max 50 keys, 100 chars per key, 500 chars per string value. |
|
|
55
|
-
| `--override_tax_type` | `string` | no | | Override the default tax classification for this specific plan. |
|
|
56
|
-
| `--payment_method_configuration` | `unknown` | no | | Explicit payment method configuration for the plan. When not provided, the account's defaults apply. |
|
|
57
|
-
| `--plan_type` | `string` | no | | Plan billing type, such as `one_time` or `renewal`. |
|
|
58
|
-
| `--product_id` | `string` | no | | The unique identifier of the product to attach this plan to. |
|
|
59
|
-
| `--release_method` | `string` | no | | Sales method for this plan. |
|
|
60
|
-
| `--renewal_price` | `number` | no | | The amount charged each billing period for recurring plans, in the plan's currency. |
|
|
61
|
-
| `--split_pay_required_payments` | `number` | no | | Installment payments required before the subscription pauses. |
|
|
62
|
-
| `--stock` | `number` | no | | The maximum number of units available for purchase. Ignored when unlimited_stock is true. |
|
|
63
|
-
| `--three_ds_level` | `string` | no | | 3D Secure behavior for this plan. Send `null` to inherit the account default. |
|
|
64
|
-
| `--title` | `unknown` | no | | The display name of the plan shown to customers on the product page. |
|
|
65
|
-
| `--trial_period_days` | `number` | no | | Free trial duration before the first recurring charge. |
|
|
66
|
-
| `--unlimited_stock` | `boolean` | no | | Whether the plan has unlimited stock. When true, the stock field is ignored. |
|
|
67
|
-
| `--visibility` | `string` | no | | Whether the plan is visible to customers or hidden from public view. |
|
|
68
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
69
|
-
|
|
70
|
-
> Confirm with the user before executing this destructive command.
|
|
71
|
-
|
|
72
|
-
---
|
|
73
|
-
|
|
74
|
-
# whop plans delete
|
|
75
|
-
|
|
76
|
-
Delete Plan
|
|
77
|
-
|
|
78
|
-
## Arguments
|
|
79
|
-
|
|
80
|
-
| Name | Type | Required | Description |
|
|
81
|
-
|------|------|----------|-------------|
|
|
82
|
-
| `id` | `string` | yes | Plan ID, prefixed `plan_`. |
|
|
83
|
-
|
|
84
|
-
> Confirm with the user before executing this destructive command.
|
|
85
|
-
|
|
86
|
-
---
|
|
87
|
-
|
|
88
|
-
# whop plans get
|
|
89
|
-
|
|
90
|
-
Retrieve Plan
|
|
91
|
-
|
|
92
|
-
## Arguments
|
|
93
|
-
|
|
94
|
-
| Name | Type | Required | Description |
|
|
95
|
-
|------|------|----------|-------------|
|
|
96
|
-
| `id` | `string` | yes | Plan ID, prefixed `plan_`. |
|
|
97
|
-
|
|
98
|
-
---
|
|
99
|
-
|
|
100
|
-
# whop plans list
|
|
101
|
-
|
|
102
|
-
List Plans
|
|
103
|
-
|
|
104
|
-
## Options
|
|
105
|
-
|
|
106
|
-
| Flag | Type | Required | Default | Description |
|
|
107
|
-
|------|------|----------|---------|-------------|
|
|
108
|
-
| `--account_id` | `string` | no | | The unique identifier of the account to list plans for. |
|
|
109
|
-
| `--direction` | `string` | no | | The sort direction for results. Defaults to descending. |
|
|
110
|
-
| `--order` | `string` | no | | The field to sort results by. Defaults to created_at. |
|
|
111
|
-
| `--release_methods` | `array` | no | | Filter to only plans matching these release methods. |
|
|
112
|
-
| `--visibilities` | `array` | no | | Filter to only plans matching these visibility states. |
|
|
113
|
-
| `--plan_types` | `array` | no | | Filter to only plans matching these billing types. |
|
|
114
|
-
| `--product_ids` | `array` | no | | Filter to only plans belonging to these product identifiers. |
|
|
115
|
-
| `--created_before` | `string` | no | | Only return plans created before this timestamp. |
|
|
116
|
-
| `--created_after` | `string` | no | | Only return plans created after this timestamp. |
|
|
117
|
-
| `--first` | `number` | no | | The number of plans to return (default and max 100). |
|
|
118
|
-
| `--after` | `string` | no | | A cursor; returns plans after this position. |
|
|
119
|
-
| `--last` | `number` | no | | The number of plans to return from the end of the range. |
|
|
120
|
-
| `--before` | `string` | no | | A cursor; returns plans before this position. |
|
|
121
|
-
|
|
122
|
-
---
|
|
123
|
-
|
|
124
|
-
# whop plans update
|
|
125
|
-
|
|
126
|
-
Update Plan
|
|
127
|
-
|
|
128
|
-
## Arguments
|
|
129
|
-
|
|
130
|
-
| Name | Type | Required | Description |
|
|
131
|
-
|------|------|----------|-------------|
|
|
132
|
-
| `id` | `string` | yes | Plan ID, prefixed `plan_`. |
|
|
133
|
-
|
|
134
|
-
## Options
|
|
135
|
-
|
|
136
|
-
| Flag | Type | Required | Default | Description |
|
|
137
|
-
|------|------|----------|---------|-------------|
|
|
138
|
-
| `--adaptive_pricing_enabled` | `boolean` | no | | Whether this plan accepts local currency payments via adaptive pricing. |
|
|
139
|
-
| `--billing_period` | `number` | no | | Recurring billing interval in days, such as 30 for monthly or 365 for annual. |
|
|
140
|
-
| `--cancel_discount_intervals` | `number` | no | | How many renewals the retention discount applies to. Required when `offer_cancel_discount` is true. |
|
|
141
|
-
| `--cancel_discount_percentage` | `number` | no | | Percentage taken off each discounted renewal. Required when `offer_cancel_discount` is true. |
|
|
142
|
-
| `--checkout_styling` | `unknown` | no | | Checkout styling overrides for this plan. |
|
|
143
|
-
| `--currency` | `string` | no | | The three-letter ISO currency code for the plan's pricing. Defaults to USD. |
|
|
144
|
-
| `--custom_fields` | `unknown` | no | | An array of custom field definitions to collect from customers at checkout. Omitting this field clears existing custom fields. |
|
|
145
|
-
| `--description` | `unknown` | no | | A text description of the plan displayed to customers on the product page. |
|
|
146
|
-
| `--expiration_days` | `number` | no | | Access duration in days before the membership expires. |
|
|
147
|
-
| `--image` | `unknown` | no | | An image displayed on the product page to represent this plan. |
|
|
148
|
-
| `--initial_price` | `number` | no | | Initial amount charged in the plan's currency, e.g. 10.43 for $10.43. |
|
|
149
|
-
| `--internal_notes` | `unknown` | no | | Private notes visible only to the account owner. Not shown to customers. |
|
|
150
|
-
| `--metadata` | `unknown` | no | | Custom key-value pairs to store on the plan. Included in webhook payloads for payment and membership events. Max 50 keys, 100 chars per key, 500 chars per string value. |
|
|
151
|
-
| `--offer_cancel_discount` | `boolean` | no | | Whether to offer a retention discount when a customer attempts to cancel. |
|
|
152
|
-
| `--override_tax_type` | `string` | no | | Override the default tax classification for this specific plan. |
|
|
153
|
-
| `--payment_method_configuration` | `unknown` | no | | Explicit payment method configuration for the plan. When not provided, the account's defaults apply. |
|
|
154
|
-
| `--release_method` | `string` | no | | Sales method for this plan. |
|
|
155
|
-
| `--renewal_price` | `number` | no | | The amount charged each billing period for recurring plans, in the plan's currency. |
|
|
156
|
-
| `--stock` | `number` | no | | The maximum number of units available for purchase. Ignored when unlimited_stock is true. |
|
|
157
|
-
| `--strike_through_initial_price` | `number` | no | | A comparison price displayed with a strikethrough for the initial price. |
|
|
158
|
-
| `--strike_through_renewal_price` | `number` | no | | A comparison price displayed with a strikethrough for the renewal price. |
|
|
159
|
-
| `--three_ds_level` | `string` | no | | 3D Secure behavior for this plan. Send `null` to inherit the account default. |
|
|
160
|
-
| `--title` | `unknown` | no | | The display name of the plan shown to customers on the product page. |
|
|
161
|
-
| `--trial_period_days` | `number` | no | | Free trial duration before the first recurring charge. |
|
|
162
|
-
| `--unlimited_stock` | `boolean` | no | | Whether the plan has unlimited stock. When true, the stock field is ignored. |
|
|
163
|
-
| `--visibility` | `string` | no | | Whether the plan is visible to customers or hidden from public view. |
|
|
164
|
-
|
|
165
|
-
> Confirm with the user before executing this destructive command.
|
|
@@ -1,153 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: whop-products
|
|
3
|
-
description: The things you sell. Each owns plans and a store page. Run `whop products --help` for usage details.
|
|
4
|
-
requires_bin: whop
|
|
5
|
-
command: whop products
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
A Product is a digital good or service sold on Whop. Products may contain plans for pricing and/or experiences for content delivery.
|
|
9
|
-
|
|
10
|
-
Use the Products API to create products, list products visible to your credentials, retrieve product details, update product metadata or merchandising fields, and delete products that should no longer be sold.
|
|
11
|
-
|
|
12
|
-
# whop products create
|
|
13
|
-
|
|
14
|
-
Create Product
|
|
15
|
-
|
|
16
|
-
## Options
|
|
17
|
-
|
|
18
|
-
| Flag | Type | Required | Default | Description |
|
|
19
|
-
|------|------|----------|---------|-------------|
|
|
20
|
-
| `--account_id` | `string` | no | | The unique identifier of the account to create this product for. |
|
|
21
|
-
| `--collect_shipping_address` | `boolean` | no | | Whether to collect a shipping address at checkout. |
|
|
22
|
-
| `--custom_cta` | `unknown` | no | | The call-to-action button label. |
|
|
23
|
-
| `--custom_cta_url` | `unknown` | no | | A URL the call-to-action button links to. |
|
|
24
|
-
| `--custom_statement_descriptor` | `unknown` | no | | Custom bank statement descriptor. Must start with WHOP*. |
|
|
25
|
-
| `--description` | `unknown` | no | | A written description displayed on the product page. |
|
|
26
|
-
| `--global_affiliate_percentage` | `number` | no | | The commission rate affiliates earn. |
|
|
27
|
-
| `--global_affiliate_status` | `string` | no | | The enrollment status in the global affiliate program. |
|
|
28
|
-
| `--headline` | `unknown` | no | | A short marketing headline for the product page. |
|
|
29
|
-
| `--member_affiliate_percentage` | `number` | no | | The commission rate members earn. |
|
|
30
|
-
| `--member_affiliate_status` | `string` | no | | The enrollment status in the member affiliate program. |
|
|
31
|
-
| `--metadata` | `unknown` | no | | Custom key-value pairs to store on the product. |
|
|
32
|
-
| `--product_tax_code_id` | `unknown` | no | | The unique identifier of the tax classification code. See the available [product categories](https://docs.numeral.com/essentials/product-categories). |
|
|
33
|
-
| `--redirect_purchase_url` | `unknown` | no | | A URL to redirect the customer to after purchase. |
|
|
34
|
-
| `--route` | `unknown` | no | | The URL slug for the product's public link. |
|
|
35
|
-
| `--send_welcome_message` | `boolean` | no | | Whether to send an automated welcome message via support chat when a user joins this product. Defaults to true. |
|
|
36
|
-
| `--title` | `string` | yes | | The display name of the product. Maximum 80 characters. |
|
|
37
|
-
| `--visibility` | `string` | no | | Whether the product is visible to customers. |
|
|
38
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
39
|
-
|
|
40
|
-
> Confirm with the user before executing this destructive command.
|
|
41
|
-
|
|
42
|
-
---
|
|
43
|
-
|
|
44
|
-
# whop products delete
|
|
45
|
-
|
|
46
|
-
Delete Product
|
|
47
|
-
|
|
48
|
-
## Arguments
|
|
49
|
-
|
|
50
|
-
| Name | Type | Required | Description |
|
|
51
|
-
|------|------|----------|-------------|
|
|
52
|
-
| `id` | `string` | yes | The unique identifier of the product. |
|
|
53
|
-
|
|
54
|
-
> Confirm with the user before executing this destructive command.
|
|
55
|
-
|
|
56
|
-
---
|
|
57
|
-
|
|
58
|
-
# whop products get
|
|
59
|
-
|
|
60
|
-
Retrieve Product
|
|
61
|
-
|
|
62
|
-
## Arguments
|
|
63
|
-
|
|
64
|
-
| Name | Type | Required | Description |
|
|
65
|
-
|------|------|----------|-------------|
|
|
66
|
-
| `id` | `string` | yes | The unique identifier of the product. |
|
|
67
|
-
|
|
68
|
-
---
|
|
69
|
-
|
|
70
|
-
# whop products list
|
|
71
|
-
|
|
72
|
-
List Products
|
|
73
|
-
|
|
74
|
-
## Options
|
|
75
|
-
|
|
76
|
-
| Flag | Type | Required | Default | Description |
|
|
77
|
-
|------|------|----------|---------|-------------|
|
|
78
|
-
| `--account_id` | `string` | no | | The unique identifier of the account to list products for. |
|
|
79
|
-
| `--visibilities` | `array` | no | | Filter to only products matching these visibility states. |
|
|
80
|
-
| `--access_pass_types` | `array` | no | | Filter to only products matching these types. |
|
|
81
|
-
| `--direction` | `string` | no | | The sort direction for results. Defaults to descending. |
|
|
82
|
-
| `--order` | `string` | no | | The field to sort results by. Defaults to created_at. |
|
|
83
|
-
| `--first` | `number` | no | | The number of products to return (default and max 100). |
|
|
84
|
-
| `--after` | `string` | no | | A cursor; returns products after this position. |
|
|
85
|
-
| `--last` | `number` | no | | The number of products to return from the end of the range. |
|
|
86
|
-
| `--before` | `string` | no | | A cursor; returns products before this position. |
|
|
87
|
-
|
|
88
|
-
---
|
|
89
|
-
|
|
90
|
-
# whop products publish
|
|
91
|
-
|
|
92
|
-
Publish Product
|
|
93
|
-
|
|
94
|
-
## Arguments
|
|
95
|
-
|
|
96
|
-
| Name | Type | Required | Description |
|
|
97
|
-
|------|------|----------|-------------|
|
|
98
|
-
| `id` | `string` | yes | The unique identifier of the product, prefixed `prod_`. |
|
|
99
|
-
|
|
100
|
-
## Options
|
|
101
|
-
|
|
102
|
-
| Flag | Type | Required | Default | Description |
|
|
103
|
-
|------|------|----------|---------|-------------|
|
|
104
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
105
|
-
|
|
106
|
-
> Confirm with the user before executing this destructive command.
|
|
107
|
-
|
|
108
|
-
---
|
|
109
|
-
|
|
110
|
-
# whop products unpublish
|
|
111
|
-
|
|
112
|
-
Unpublish Product
|
|
113
|
-
|
|
114
|
-
## Arguments
|
|
115
|
-
|
|
116
|
-
| Name | Type | Required | Description |
|
|
117
|
-
|------|------|----------|-------------|
|
|
118
|
-
| `id` | `string` | yes | The unique identifier of the product, prefixed `prod_`. |
|
|
119
|
-
|
|
120
|
-
## Options
|
|
121
|
-
|
|
122
|
-
| Flag | Type | Required | Default | Description |
|
|
123
|
-
|------|------|----------|---------|-------------|
|
|
124
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
125
|
-
|
|
126
|
-
> Confirm with the user before executing this destructive command.
|
|
127
|
-
|
|
128
|
-
---
|
|
129
|
-
|
|
130
|
-
# whop products update
|
|
131
|
-
|
|
132
|
-
Update Product
|
|
133
|
-
|
|
134
|
-
## Arguments
|
|
135
|
-
|
|
136
|
-
| Name | Type | Required | Description |
|
|
137
|
-
|------|------|----------|-------------|
|
|
138
|
-
| `id` | `string` | yes | The unique identifier of the product. |
|
|
139
|
-
|
|
140
|
-
## Options
|
|
141
|
-
|
|
142
|
-
| Flag | Type | Required | Default | Description |
|
|
143
|
-
|------|------|----------|---------|-------------|
|
|
144
|
-
| `--banner_image` | `unknown` | no | | A wide image for the product, shown on the product page and on listing cards. Pass `{ id }` for an existing attachment or `{ direct_upload_id }` for a completed direct upload; `null` removes it. |
|
|
145
|
-
| `--description` | `unknown` | no | | A written description displayed on the product page. |
|
|
146
|
-
| `--headline` | `unknown` | no | | A short marketing headline for the product page. |
|
|
147
|
-
| `--metadata` | `unknown` | no | | Custom key-value pairs to store on the product. |
|
|
148
|
-
| `--product_tax_code_id` | `unknown` | no | | The unique identifier of the tax classification code. See the available [product categories](https://docs.numeral.com/essentials/product-categories). |
|
|
149
|
-
| `--send_welcome_message` | `boolean` | no | | Whether to send an automated welcome message via support chat when a user joins this product. |
|
|
150
|
-
| `--title` | `string` | no | | The display name of the product. |
|
|
151
|
-
| `--visibility` | `string` | no | | Whether the product is visible to customers. |
|
|
152
|
-
|
|
153
|
-
> Confirm with the user before executing this destructive command.
|
|
@@ -1,59 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: whop-recommended-actions
|
|
3
|
-
description: Suggested next-step action chains for an account. Run `whop recommended-actions --help` for usage details.
|
|
4
|
-
requires_bin: whop
|
|
5
|
-
command: whop recommended-actions
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
A Recommended Action Chain is a short, ordered sequence of dashboard actions — create a product, price it, publish it — suggested for an account based on what it already has. Seeded chains come from hand-written presets; generated chains, produced per account, share the same shape.
|
|
9
|
-
|
|
10
|
-
Use the Recommended Actions API to list the chains recommended for an account and to record that a chain was run. Running a chain executes nothing server-side — the client follows each step's CTA itself; the run endpoint records the `recommended_action_chain.executed` analytics event.
|
|
11
|
-
|
|
12
|
-
# whop recommended-actions create
|
|
13
|
-
|
|
14
|
-
Run Recommended Action
|
|
15
|
-
|
|
16
|
-
## Arguments
|
|
17
|
-
|
|
18
|
-
| Name | Type | Required | Description |
|
|
19
|
-
|------|------|----------|-------------|
|
|
20
|
-
| `id` | `string` | yes | Chain ID from the list endpoint, e.g. `rac_seed_start_selling_9f2c1a7b04`. |
|
|
21
|
-
|
|
22
|
-
## Options
|
|
23
|
-
|
|
24
|
-
| Flag | Type | Required | Default | Description |
|
|
25
|
-
|------|------|----------|---------|-------------|
|
|
26
|
-
| `--account_id` | `string` | no | | Account ID, prefixed `biz_`. Defaults to the API key's own account. |
|
|
27
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
28
|
-
|
|
29
|
-
> Confirm with the user before executing this destructive command.
|
|
30
|
-
|
|
31
|
-
---
|
|
32
|
-
|
|
33
|
-
# whop recommended-actions get
|
|
34
|
-
|
|
35
|
-
Retrieve Recommended Action
|
|
36
|
-
|
|
37
|
-
## Arguments
|
|
38
|
-
|
|
39
|
-
| Name | Type | Required | Description |
|
|
40
|
-
|------|------|----------|-------------|
|
|
41
|
-
| `id` | `string` | yes | Chain ID from the list endpoint, e.g. `rac_seed_start_selling_9f2c1a7b04`. |
|
|
42
|
-
|
|
43
|
-
## Options
|
|
44
|
-
|
|
45
|
-
| Flag | Type | Required | Default | Description |
|
|
46
|
-
|------|------|----------|---------|-------------|
|
|
47
|
-
| `--account_id` | `string` | no | | Account ID, prefixed `biz_`. Defaults to the API key's own account. |
|
|
48
|
-
|
|
49
|
-
---
|
|
50
|
-
|
|
51
|
-
# whop recommended-actions list
|
|
52
|
-
|
|
53
|
-
List Recommended Actions
|
|
54
|
-
|
|
55
|
-
## Options
|
|
56
|
-
|
|
57
|
-
| Flag | Type | Required | Default | Description |
|
|
58
|
-
|------|------|----------|---------|-------------|
|
|
59
|
-
| `--account_id` | `string` | no | | Account ID, prefixed `biz_`. Defaults to the API key's own account. |
|