@whop/cli 0.16.0 → 0.16.2

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.
Files changed (55) hide show
  1. package/README.md +17 -3
  2. package/dist/index.js +6647 -15750
  3. package/dist/index.js.map +1 -1
  4. package/dist/vite-devtools-stub.d.ts +22 -0
  5. package/dist/vite-devtools-stub.js +19 -0
  6. package/dist/vite-devtools-stub.js.map +1 -0
  7. package/dist/vite.d.ts +17 -2
  8. package/dist/vite.js +30 -5
  9. package/dist/vite.js.map +1 -1
  10. package/package.json +8 -7
  11. package/skills/whop/SKILL.md +48 -0
  12. package/skills/whop/references/ads.md +43 -0
  13. package/skills/whop/references/formation.md +40 -0
  14. package/skills/whop/references/websites.md +59 -0
  15. package/skills/whop-accounts/SKILL.md +0 -228
  16. package/skills/whop-ad-campaigns/SKILL.md +0 -204
  17. package/skills/whop-ad-groups/SKILL.md +0 -269
  18. package/skills/whop-ads/SKILL.md +0 -277
  19. package/skills/whop-api-keys/SKILL.md +0 -126
  20. package/skills/whop-app-builds/SKILL.md +0 -81
  21. package/skills/whop-apps/SKILL.md +0 -161
  22. package/skills/whop-audiences/SKILL.md +0 -105
  23. package/skills/whop-bounties/SKILL.md +0 -145
  24. package/skills/whop-bounty-submissions/SKILL.md +0 -95
  25. package/skills/whop-cards/SKILL.md +0 -133
  26. package/skills/whop-checkout-configurations/SKILL.md +0 -77
  27. package/skills/whop-deposits/SKILL.md +0 -26
  28. package/skills/whop-dispute-alerts/SKILL.md +0 -42
  29. package/skills/whop-disputes/SKILL.md +0 -99
  30. package/skills/whop-events/SKILL.md +0 -105
  31. package/skills/whop-exports/SKILL.md +0 -379
  32. package/skills/whop-ledgers/SKILL.md +0 -52
  33. package/skills/whop-media/SKILL.md +0 -44
  34. package/skills/whop-members/SKILL.md +0 -64
  35. package/skills/whop-memberships/SKILL.md +0 -165
  36. package/skills/whop-notifications/SKILL.md +0 -104
  37. package/skills/whop-partners/SKILL.md +0 -113
  38. package/skills/whop-payment-method-domains/SKILL.md +0 -93
  39. package/skills/whop-payments/SKILL.md +0 -40
  40. package/skills/whop-payouts/SKILL.md +0 -167
  41. package/skills/whop-people/SKILL.md +0 -63
  42. package/skills/whop-permissions/SKILL.md +0 -21
  43. package/skills/whop-plans/SKILL.md +0 -165
  44. package/skills/whop-products/SKILL.md +0 -153
  45. package/skills/whop-recommended-actions/SKILL.md +0 -59
  46. package/skills/whop-resolution-center-cases/SKILL.md +0 -233
  47. package/skills/whop-setup-intents/SKILL.md +0 -40
  48. package/skills/whop-shipments/SKILL.md +0 -79
  49. package/skills/whop-social-accounts/SKILL.md +0 -128
  50. package/skills/whop-stats/SKILL.md +0 -65
  51. package/skills/whop-swaps/SKILL.md +0 -77
  52. package/skills/whop-team-members/SKILL.md +0 -93
  53. package/skills/whop-transfers/SKILL.md +0 -80
  54. package/skills/whop-users/SKILL.md +0 -309
  55. package/skills/whop-verifications/SKILL.md +0 -67
@@ -1,99 +0,0 @@
1
- ---
2
- name: whop-disputes
3
- description: Chargebacks filed against an account, with evidence and outcomes. Run `whop disputes --help` for usage details.
4
- requires_bin: whop
5
- command: whop disputes
6
- ---
7
-
8
- A Dispute is a chargeback a customer files against a payment through their bank, or an inquiry that may become one. It carries the disputed payment, a deadline to respond, your evidence, and the outcome once the processor rules.
9
-
10
- Use the Disputes API to list disputes, edit the evidence packet while a dispute is still contestable, and submit it for review.
11
-
12
- # whop disputes get
13
-
14
- Retrieve Dispute
15
-
16
- ## Arguments
17
-
18
- | Name | Type | Required | Description |
19
- |------|------|----------|-------------|
20
- | `id` | `string` | yes | The dispute ID (`dspt_` tag). |
21
-
22
- ---
23
-
24
- # whop disputes list
25
-
26
- List Disputes
27
-
28
- ## Options
29
-
30
- | Flag | Type | Required | Default | Description |
31
- |------|------|----------|---------|-------------|
32
- | `--account_id` | `string` | no | | Only disputes filed against this account (`biz_` tag). Omit it to cover every account you can read. |
33
- | `--first` | `number` | no | | The number of disputes to return (default 20, max 100). |
34
- | `--after` | `string` | no | | A cursor; returns disputes after this position. |
35
- | `--last` | `number` | no | | The number of disputes to return from the end of the range. |
36
- | `--before` | `string` | no | | A cursor; returns disputes before this position. |
37
- | `--order` | `string` | no | | The field to sort disputes by. |
38
- | `--direction` | `string` | no | | Sort direction. |
39
- | `--status` | `array` | no | | Only disputes in these statuses. Repeat the parameter to pass several — one paginated list covers all of them. Covers both chargebacks and inquiries at each stage. |
40
- | `--currency` | `string` | no | | Only disputes in this three-letter ISO currency. |
41
- | `--created_before` | `string` | no | | Only disputes opened before this ISO 8601 timestamp. |
42
- | `--created_after` | `string` | no | | Only disputes opened after this ISO 8601 timestamp. |
43
-
44
- ---
45
-
46
- # whop disputes submit
47
-
48
- Submit Dispute
49
-
50
- ## Arguments
51
-
52
- | Name | Type | Required | Description |
53
- |------|------|----------|-------------|
54
- | `id` | `string` | yes | The dispute ID (`dspt_` tag). |
55
-
56
- ## Options
57
-
58
- | Flag | Type | Required | Default | Description |
59
- |------|------|----------|---------|-------------|
60
- | `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
61
-
62
- > Confirm with the user before executing this destructive command.
63
-
64
- ---
65
-
66
- # whop disputes summary
67
-
68
- Retrieve Dispute Summary
69
-
70
- ## Options
71
-
72
- | Flag | Type | Required | Default | Description |
73
- |------|------|----------|---------|-------------|
74
- | `--groups` | `array` | no | | Which breakdowns to return, keyed by these names under `groups`. Repeat the parameter to ask for several; omit it for all of them. |
75
- | `--account_id` | `string` | no | | Only disputes filed against this account (`biz_` tag). Omit it to cover every account you can read. |
76
- | `--status` | `array` | no | | Only disputes in these statuses. Repeat the parameter to pass several. |
77
- | `--currency` | `string` | no | | Only disputes in this three-letter ISO currency. |
78
- | `--created_before` | `string` | no | | Only disputes opened before this ISO 8601 timestamp. |
79
- | `--created_after` | `string` | no | | Only disputes opened after this ISO 8601 timestamp. |
80
-
81
- ---
82
-
83
- # whop disputes update
84
-
85
- Update Dispute
86
-
87
- ## Arguments
88
-
89
- | Name | Type | Required | Description |
90
- |------|------|----------|-------------|
91
- | `id` | `string` | yes | The dispute ID (`dspt_` tag). |
92
-
93
- ## Options
94
-
95
- | Flag | Type | Required | Default | Description |
96
- |------|------|----------|---------|-------------|
97
- | `--evidence` | `object` | no | | The evidence packet to send to the processor. Only the fields you provide are changed. |
98
-
99
- > Confirm with the user before executing this destructive command.
@@ -1,105 +0,0 @@
1
- ---
2
- name: whop-events
3
- description: Conversion and engagement events tracked for attribution. Run `whop events --help` for usage details.
4
- requires_bin: whop
5
- command: whop events
6
- ---
7
-
8
- An Event records conversion or engagement activity for an account, such as page views, purchases, or leads. Each event ties the action to the [person](https://docs.whop.com/api-reference/beta/people/person) who took it, so activity can be attributed to the ads and links that drove it.
9
-
10
- Use the Events API to send new tracking events, list recent identity-linked events for an account, and inspect the events recorded for a person. The resource also exposes an anonymized read mode — the pulse feed — a platform-wide snapshot of recent purchases that carries nothing identifying. The pulse feed is public; other Events endpoints require authentication and are scoped to an account.
11
-
12
- Events are only as good as the pixel sending them, so [Validate Pixel](https://docs.whop.com/api-reference/beta/events/validate-pixel) answers whether an account's pixel is working: it reads the events the pixel has sent, and when you pass a `url` whose page hasn't sent any lately, it fetches that page and looks for the pixel in its source. Use it before launching an ad to confirm its destination is tracked, or in a setup flow to tell a merchant whether their install is live.
13
-
14
- # whop events create
15
-
16
- Create Event
17
-
18
- ## Options
19
-
20
- | Flag | Type | Required | Default | Description |
21
- |------|------|----------|---------|-------------|
22
- | `--account_id` | `string` | yes | | The account to associate with this event. |
23
- | `--action_source` | `unknown` | no | | Where the event originated. |
24
- | `--context` | `unknown` | no | | Tracking and attribution context. |
25
- | `--currency` | `unknown` | no | | ISO 4217 currency code. |
26
- | `--custom_name` | `unknown` | no | | Custom event name when event_name is 'custom'. Maximum 35 chars for this value. |
27
- | `--duration` | `number` | no | | For 'leave' events: milliseconds the visitor spent on the page. |
28
- | `--event_id` | `unknown` | no | | Client-provided identifier for deduplication. Generated if omitted. |
29
- | `--event_name` | `string` | yes | | The type of event.
30
-
31
- Use a standard event (lead, submit_application, contact, complete_registration, schedule, view_content, add_to_cart) or pass your own name directly for a custom event. |
32
- | `--event_time` | `unknown` | no | | When the event occurred. Defaults to now. |
33
- | `--plan_id` | `unknown` | no | | The plan associated with the event. |
34
- | `--product_id` | `unknown` | no | | The product associated with the event. |
35
- | `--referrer_url` | `unknown` | no | | The referring URL. |
36
- | `--resumed` | `boolean` | no | | For 'page' events: true when the page was restored from the back/forward cache. |
37
- | `--source` | `unknown` | no | | For 'identify' events: where the identity was captured (url, form, manual, iframe). |
38
- | `--title` | `unknown` | no | | For 'page' events: the document title. |
39
- | `--url` | `unknown` | no | | The URL where the event occurred. |
40
- | `--user` | `unknown` | no | | User identity and profile data. |
41
- | `--value` | `number` | no | | Monetary value associated with the event. |
42
- | `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
43
-
44
- > Confirm with the user before executing this destructive command.
45
-
46
- ---
47
-
48
- # whop events list
49
-
50
- List Events
51
-
52
- ## Options
53
-
54
- | Flag | Type | Required | Default | Description |
55
- |------|------|----------|---------|-------------|
56
- | `--identifier` | `string` | no | | Any hard identifier of the person: a person ID (prsn_*), user ID, email, phone number, or a tracking cookie value (wuid, anonymous ID, fbp/fbc/ttp/ga). Omit to list recent events for the account. |
57
- | `--account_id` | `string` | no | | Account ID, prefixed `biz_`. Optional for account API keys; required for credentials that can access multiple accounts. |
58
- | `--from` | `string` | no | | Start of the time range as an ISO 8601 timestamp. Required when identifier is omitted. |
59
- | `--to` | `string` | no | | End of the time range as an ISO 8601 timestamp. Required when identifier is omitted; otherwise defaults to now. |
60
- | `--first` | `number` | no | | The number of events to return. |
61
- | `--after` | `string` | no | | A cursor for fetching events after a previous page. |
62
- | `--before` | `string` | no | | A cursor for fetching events before a later page. |
63
- | `--direction` | `string` | no | | The order events are returned in by time. Defaults to desc (most recent first); asc reads a journey forwards from where it starts. after and before always page forwards and backwards through that order. |
64
- | `--event` | `string` | no | | Full event names to filter by, comma-separated (payment.completed, pixel.lead, pixel.page, pixel.custom:<name>) — the same vocabulary the events / people metrics use. |
65
- | `--source` | `string` | no | | Canonical source path, exact or with a trailing :* prefix (whop:<campaign>:*, ext:meta:*, referrer:<domain>, direct). Restricts the list to conversion targets attributed to that source — the debuggability twin of a metric cell's source parameter. |
66
- | `--attribution_model` | `string` | no | | Attribution model for the source filter (defaults to last_touch). |
67
- | `--country` | `string` | no | | Country codes to filter by, comma-separated. |
68
- | `--city` | `string` | no | | Cities to filter by, comma-separated. |
69
- | `--device` | `string` | no | | Device families to filter by, comma-separated (e.g. iPhone, Mac). |
70
- | `--browser` | `string` | no | | Browser families to filter by, comma-separated (e.g. Chrome, Mobile Safari). |
71
- | `--os` | `string` | no | | Operating system families to filter by, comma-separated (e.g. iOS, Windows). |
72
- | `--utm_source` | `string` | no | | utm_source values to filter by, comma-separated. |
73
- | `--hostname` | `string` | no | | Page hostnames to filter by, comma-separated. |
74
- | `--page` | `string` | no | | Page paths to filter by, comma-separated. |
75
-
76
- ---
77
-
78
- # whop events pulse
79
-
80
- Retrieve the pulse feed
81
-
82
- ## Options
83
-
84
- | Flag | Type | Required | Default | Description |
85
- |------|------|----------|---------|-------------|
86
- | `--event` | `string` | no | | Filter to one or more types, comma separated — for example `purchase,card_spend`. These are the item's `type`, not its `event_name`: several types share the `ledger_line.created` event name. Omit for every type in the feed. Values outside the feed's own set are rejected. |
87
- | `--first` | `number` | no | | The number of events to return. |
88
- | `--after` | `string` | no | | A cursor for fetching events after a previous page. |
89
- | `--before` | `string` | no | | A cursor for fetching events before a later page. |
90
-
91
- ---
92
-
93
- # whop events validate_pixel
94
-
95
- Validate Pixel
96
-
97
- ## Options
98
-
99
- | Flag | Type | Required | Default | Description |
100
- |------|------|----------|---------|-------------|
101
- | `--account_id` | `string` | no | | Account to check. Defaults to the authenticated account. |
102
- | `--url` | `string` | no | | A page to read for the pixel, e.g. an ad destination. Omit it to check the account from its events alone. |
103
- | `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
104
-
105
- > Confirm with the user before executing this destructive command.
@@ -1,379 +0,0 @@
1
- ---
2
- name: whop-exports
3
- description: Asynchronous CSV dumps of an account's dashboard data. Run `whop exports --help` for usage details.
4
- requires_bin: whop
5
- command: whop exports
6
- ---
7
-
8
- An Export is an asynchronous CSV of one resource for one account — members, payments, disputes, ads, and the other tables the Whop dashboard can export. Generating a full table takes longer than a request, so an export is created in `pending`, moves through `processing`, and lands on `completed` with a download link. Each resource requires that resource's own export scope.
9
-
10
- Use the Exports API to start an export, poll it until `download_url` is set, and list the exports already requested for an account. Finished CSVs are retained for 30 days, after which the file is deleted and the export moves to `expired`.
11
-
12
- # whop exports create
13
-
14
- Create Export
15
-
16
- ## Options
17
-
18
- | Flag | Type | Required | Default | Description |
19
- |------|------|----------|---------|-------------|
20
- | `--account_id` | `string` | no | | The account to export from, prefixed `biz_`. Defaults to the credential's account. |
21
- | `--columns` | `array` | no | | Column keys to include. Empty means all columns for the resource. |
22
- | `--filters` | `object` | no | | Resource-specific filters. For native REST resources (`payouts`, `transfers`, `memberships`) these are the resource's own list query params; for dashboard tables they mirror the dashboard table filters.
23
-
24
- <details>
25
- <summary>Filters by resource (25)</summary>
26
-
27
- <details>
28
- <summary>ad_campaigns (4)</summary>
29
-
30
- Mirrors the filtering query params of `GET /api/v1/ad_campaigns`.
31
-
32
- - `created_after` `string` — Only return campaigns created after this timestamp.
33
- - `created_before` `string` — Only return campaigns created before this timestamp.
34
- - `query` `string` — Filter campaigns by a title or ID substring.
35
- - `status` `string` — Only return campaigns with this status. One of `draft`, `active`, `paused`, `payment_failed`.
36
-
37
- </details>
38
- <details>
39
- <summary>ad_groups (6)</summary>
40
-
41
- Mirrors the filtering query params of `GET /api/v1/ad_groups`.
42
-
43
- - `ad_campaign_id` `string` — Filter to ad groups in this campaign.
44
- - `ad_campaign_ids` `string[]` — Filter to ad groups in these campaigns (max 100). Repeat the parameter for each id (ad_campaign_ids=a&ad_campaign_ids=b).
45
- - `created_after` `string` — Only return ad groups created after this timestamp.
46
- - `created_before` `string` — Only return ad groups created before this timestamp.
47
- - `query` `string` — Filter ad groups by a title or ID substring.
48
- - `status` `string` — Filter to ad groups with this status. One of `active`, `paused`, `rejected`, `duplicating`.
49
-
50
- </details>
51
- <details>
52
- <summary>ads (8)</summary>
53
-
54
- Mirrors the filtering query params of `GET /api/v1/ads`.
55
-
56
- - `ad_campaign_id` `string` — Only return ads in this ad campaign.
57
- - `ad_campaign_ids` `string[]` — Only return ads in these ad campaigns (max 100). Repeat the parameter for each id (ad_campaign_ids=a&ad_campaign_ids=b).
58
- - `ad_group_id` `string` — Only return ads in this ad group.
59
- - `ad_group_ids` `string[]` — Only return ads in these ad groups (max 100). Repeat the parameter for each id (ad_group_ids=a&ad_group_ids=b).
60
- - `created_after` `string` — Only return ads created after this timestamp.
61
- - `created_before` `string` — Only return ads created before this timestamp.
62
- - `query` `string` — Filter ads by a title or ID substring.
63
- - `status` `string` — Only return ads with this status. One of `active`, `paused`, `in_review`, `rejected`.
64
-
65
- </details>
66
- <details>
67
- <summary>apps (4)</summary>
68
-
69
- Mirrors the filtering query params of `GET /api/v1/apps`.
70
-
71
- - `app_type` `string` — Filter apps by the type of end-user they are built for. Apps of type `website` are left out unless you ask for them by name. One of `b2b_app`, `b2c_app`, `company_app`, `component`, `website`.
72
- - `query` `string` — A search string matched against app names.
73
- - `verified_apps_only` `boolean` — Whether to only return apps verified by Whop. Verified website templates — websites with a published web build — are included, even though websites are otherwise left out of app lists.
74
- - `view_type` `string` — Only return apps supporting this view type, such as `dashboard` or `hub`. One of `hub`, `discover`, `dash`, `dashboard`, `analytics`, `skills`, `openapi`.
75
-
76
- </details>
77
- <details>
78
- <summary>audiences (3)</summary>
79
-
80
- Mirrors the filtering query params of `GET /api/v1/audiences`.
81
-
82
- - `audience_id` `string` — Audience ID, prefixed `adaud_`, used to filter the response to one audience.
83
- - `audience_type` `string` — Filter by audience type: `custom` (uploaded lists) or `lookalike`. One of `custom`, `lookalike`.
84
- - `source_type` `string` — Filter by member source: `csv_upload` (uploaded lists) or `people_filter` (automatic audiences built from saved People filters). One of `csv_upload`, `people_filter`.
85
-
86
- </details>
87
- <details>
88
- <summary>bounties (5)</summary>
89
-
90
- Mirrors the filtering query params of `GET /api/v1/bounties`.
91
-
92
- - `created_after` `string` — Only bounties created after this ISO 8601 timestamp.
93
- - `created_before` `string` — Only bounties created before this ISO 8601 timestamp.
94
- - `query` `string` — Substring match on the bounty title or ID.
95
- - `status` `string` — Filter by lifecycle state. One of `scheduled`, `open`, `closed`, `completed`, `canceled`.
96
- - `user_id` `string` — List the bounties this user participated in (`user_` tag). Must be the authenticated user.
97
-
98
- </details>
99
- <details>
100
- <summary>bounty_submissions (4)</summary>
101
-
102
- Mirrors the filtering query params of `GET /api/v1/bounty_submissions`.
103
-
104
- - `bounty_id` `string` — Only submissions on this bounty (`bnty_` tag).
105
- - `created_after` `string` — Only submissions created after this ISO 8601 timestamp.
106
- - `created_before` `string` — Only submissions created before this ISO 8601 timestamp.
107
- - `status` `string` — Filter by lifecycle state. One of `in_progress`, `submitted`, `approved`, `denied`.
108
-
109
- </details>
110
- <details>
111
- <summary>card_transactions (6)</summary>
112
-
113
- Mirrors the filtering query params of `GET /api/v1/card_transactions`.
114
-
115
- - `card_id` `string[]` — Return only transactions charged to these cards, each prefixed `icrd_`.
116
- - `cardholder_id` `string[]` — Return only transactions on cards assigned to these users, each prefixed `user_`.
117
- - `created_after` `string` — Return only transactions authorized at or after this ISO 8601 timestamp.
118
- - `created_before` `string` — Return only transactions authorized at or before this ISO 8601 timestamp.
119
- - `status` `string` — Return only transactions with this status. One of `pending`, `completed`, `reversed`, `declined`.
120
- - `transaction_ids` `string[]` — Return only these card transactions, each prefixed `citx_`. Repeat the parameter, or pass one comma-separated value.
121
-
122
- </details>
123
- <details>
124
- <summary>checkout_configurations (3)</summary>
125
-
126
- Mirrors the filtering query params of `GET /api/v1/checkout_configurations`.
127
-
128
- - `created_after` `string` — Only return checkout configurations created after this ISO 8601 timestamp.
129
- - `created_before` `string` — Only return checkout configurations created before this ISO 8601 timestamp.
130
- - `plan_id` `string` — Only return checkout configurations for this plan ID, prefixed `plan_`.
131
-
132
- </details>
133
- <details>
134
- <summary>disputes (4)</summary>
135
-
136
- Mirrors the filtering query params of `GET /api/v1/disputes`.
137
-
138
- - `created_after` `string` — Only disputes opened after this ISO 8601 timestamp.
139
- - `created_before` `string` — Only disputes opened before this ISO 8601 timestamp.
140
- - `currency` `string` — Only disputes in this three-letter ISO currency.
141
- - `status` `string[]` — Only disputes in these statuses. Repeat the parameter to pass several — one paginated list covers all of them. Covers both chargebacks and inquiries at each stage.
142
-
143
- </details>
144
- <details>
145
- <summary>events (14)</summary>
146
-
147
- Mirrors the filtering query params of `GET /api/v1/events`.
148
-
149
- - `attribution_model` `string` — Attribution model for the source filter (defaults to last_touch). One of `last_touch`, `first_touch`.
150
- - `browser` `string` — Browser families to filter by, comma-separated (e.g. Chrome, Mobile Safari).
151
- - `city` `string` — Cities to filter by, comma-separated.
152
- - `country` `string` — Country codes to filter by, comma-separated.
153
- - `device` `string` — Device families to filter by, comma-separated (e.g. iPhone, Mac).
154
- - `event` `string` — Full event names to filter by, comma-separated (payment.completed, pixel.lead, pixel.page, pixel.custom:<name>) — the same vocabulary the events / people metrics use.
155
- - `from` `string` — Start of the time range as an ISO 8601 timestamp. Required when identifier is omitted.
156
- - `hostname` `string` — Page hostnames to filter by, comma-separated.
157
- - `identifier` `string` — Any hard identifier of the person: a person ID (prsn_*), user ID, email, phone number, or a tracking cookie value (wuid, anonymous ID, fbp/fbc/ttp/ga). Omit to list recent events for the account.
158
- - `os` `string` — Operating system families to filter by, comma-separated (e.g. iOS, Windows).
159
- - `page` `string` — Page paths to filter by, comma-separated.
160
- - `source` `string` — Canonical source path, exact or with a trailing :* prefix (whop:<campaign>:*, ext:meta:*, referrer:<domain>, direct). Restricts the list to conversion targets attributed to that source — the debuggability twin of a metric cell's source parameter.
161
- - `to` `string` — End of the time range as an ISO 8601 timestamp. Required when identifier is omitted; otherwise defaults to now.
162
- - `utm_source` `string` — utm_source values to filter by, comma-separated.
163
-
164
- </details>
165
- <details>
166
- <summary>financial-activity (9)</summary>
167
-
168
- Mirrors the filtering query params of `GET /api/v1/financial-activity`.
169
-
170
- - `available_after` `string` — Only include rows whose funds became withdrawable on or after this `YYYY-MM-DD` settlement date (UTC), distinct from posted_at. Requires currency.
171
- - `available_before` `string` — Only include rows whose funds became withdrawable on or before this `YYYY-MM-DD` settlement date (UTC). Set equal to available_after for a single day. Requires currency.
172
- - `currency` `string` — Optional currency code filter, for example `usd`.
173
- - `include_owned_accounts` `boolean` — When true, aggregates the authenticated user's personal ledger with the businesses they own (owner role with balance read) into one feed. Requires user_id to be the authenticated user; cannot be combined with account_id or the settlement-date filters. Each returned row includes the owning `account`.
174
- - `include_resource` `boolean` — Whether to include the `resource` field in the response or not. Consider passing `false` if you need a fast response without as many rich details.
175
- - `line_types` `string[]` — Optional ledger line categories to include. Some categories (for example `onchain_deposit`, which covers inbound crypto deposits such as MoonPay onramps) are only returned when explicitly requested here.
176
- - `posted_after` `string` — Only include rows posted after this ISO 8601 timestamp.
177
- - `posted_before` `string` — Only include rows posted before this ISO 8601 timestamp.
178
- - `user_id` `string` — The owning user ID (a user_ identifier). Provide this or account_id.
179
-
180
- </details>
181
- <details>
182
- <summary>members (5)</summary>
183
-
184
- Mirrors the filtering query params of `GET /api/v1/members`.
185
-
186
- - `access_level` `string` — Filter by what the member can reach on the account. One of `no_access`, `admin`, `customer`.
187
- - `created_after` `string` — Only members who joined after this ISO 8601 timestamp.
188
- - `created_before` `string` — Only members who joined before this ISO 8601 timestamp.
189
- - `query` `string` — Search members by name or username. An exact email address also matches when the credential holds the member:email:read scope.
190
- - `status` `string` — Filter by whether the member is still part of the account. One of `joined`, `left`.
191
-
192
- </details>
193
- <details>
194
- <summary>memberships (6)</summary>
195
-
196
- Mirrors the filtering query params of `GET /api/v1/memberships`.
197
-
198
- - `created_after` `string` — Only memberships created after this ISO 8601 timestamp.
199
- - `created_before` `string` — Only memberships created before this ISO 8601 timestamp.
200
- - `plan_id` `string` — Filter to memberships of this plan (`plan_` tag). Repeat as plan_ids[] for several.
201
- - `product_id` `string` — Filter to memberships of this product (`prod_` tag). Repeat as product_ids[] for several.
202
- - `status` `string` — Filter by billing state. `canceling` matches active memberships set to cancel at period end; `paused` matches memberships with payment collection paused. One of `active`, `trialing`, `past_due`, `completed`, `canceled`, `expired`, `canceling`, `paused`.
203
- - `user_id` `string` — Narrow to one user's memberships (`user_` tag, or `me` for the caller). A user outside the caller's visible set returns an empty list.
204
-
205
- </details>
206
- <details>
207
- <summary>payouts (2)</summary>
208
-
209
- Mirrors the filtering query params of `GET /api/v1/payouts`.
210
-
211
- - `currency` `string` — Optional currency code filter, for example `usd`.
212
- - `user_id` `string` — The owning user ID (a user_ identifier). Provide this or account_id.
213
-
214
- </details>
215
- <details>
216
- <summary>people (20)</summary>
217
-
218
- Mirrors the filtering query params of `GET /api/v1/people`.
219
-
220
- - `attribution_model` `string` — Attribution model the source filter matches against (defaults to last_touch). One of `last_touch`, `first_touch`.
221
- - `audience_id` `string` — 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.
222
- - `contactable` `boolean` — true for people who have an email address or phone number — the ones an ad platform can match.
223
- - `country` `string` — Only include people whose most recent visit came from this ISO 3166-1 alpha-2 country code.
224
- - `custom_event` `string` — Only include people who fired this custom pixel event.
225
- - `email` `string` — Only include the person linked to this email address.
226
- - `event_from` `string` — 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.
227
- - `event_name` `string[]` — Only include people who fired any of these events, e.g. payment.completed or page.checkout.view.
228
- - `event_to` `string` — The inclusive end of the event window for exact-population mode.
229
- - `first_seen_after` `string` — Only include people first seen at or after this ISO 8601 timestamp.
230
- - `first_seen_before` `string` — Only include people first seen before this ISO 8601 timestamp.
231
- - `first_seen_within_days` `integer` — Only include people first seen within this many days, as a rolling window.
232
- - `has_purchased` `boolean` — true for customers only, false for people who have never purchased.
233
- - `last_seen_after` `string` — Only include people last seen at or after this ISO 8601 timestamp.
234
- - `last_seen_before` `string` — Only include people last seen before this ISO 8601 timestamp.
235
- - `last_seen_within_days` `integer` — Only include people last seen within this many days, as a rolling window.
236
- - `phone` `string` — Only include the person linked to this phone number.
237
- - `query` `string` — Search people by name, email, phone, or whop user ID (case-insensitive substring match).
238
- - `source` `string[]` — 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.
239
- - `user_id` `string` — Only include the person linked to this whop user ID.
240
-
241
- </details>
242
- <details>
243
- <summary>plans (6)</summary>
244
-
245
- Mirrors the filtering query params of `GET /api/v1/plans`.
246
-
247
- - `created_after` `string` — Only return plans created after this timestamp.
248
- - `created_before` `string` — Only return plans created before this timestamp.
249
- - `plan_types` `string[]` — Filter to only plans matching these billing types.
250
- - `product_ids` `string[]` — Filter to only plans belonging to these product identifiers.
251
- - `release_methods` `string[]` — Filter to only plans matching these release methods.
252
- - `visibilities` `string[]` — Filter to only plans matching these visibility states.
253
-
254
- </details>
255
- <details>
256
- <summary>products (2)</summary>
257
-
258
- Mirrors the filtering query params of `GET /api/v1/products`.
259
-
260
- - `access_pass_types` `string[]` — Filter to only products matching these types.
261
- - `visibilities` `string[]` — Filter to only products matching these visibility states.
262
-
263
- </details>
264
- <details>
265
- <summary>promo_codes (5)</summary>
266
-
267
- Mirrors the filtering query params of `GET /api/v1/promo_codes`.
268
-
269
- - `created_after` `string` — Only promo codes created after this ISO 8601 timestamp.
270
- - `created_before` `string` — Only promo codes created before this ISO 8601 timestamp.
271
- - `plan_ids` `string[]` — Only promo codes scoped to these plan IDs.
272
- - `product_ids` `string[]` — Only promo codes scoped to these product IDs.
273
- - `status` `string` — Promo-code status. `expired` groups inactive and archived codes. One of `active`, `inactive`, `archived`, `expired`.
274
-
275
- </details>
276
- <details>
277
- <summary>resolution_center_cases (6)</summary>
278
-
279
- Mirrors the filtering query params of `GET /api/v1/resolution_center_cases`.
280
-
281
- - `created_after` `string` — Only cases created after this ISO 8601 timestamp.
282
- - `created_before` `string` — Only cases created before this ISO 8601 timestamp.
283
- - `outcome` `string[]` — Only closed cases that ended these ways. Repeat the parameter to pass several.
284
- - `reason` `string[]` — Only cases opened for these reasons. Repeat the parameter to pass several.
285
- - `status` `string[]` — Only cases in these statuses. Repeat the parameter to pass several — one paginated list covers all of them.
286
- - `user_id` `string` — Only cases opened by this customer — a `user_` tag, or `me` for the calling user. It narrows what you can already read, so `me` lists the cases you opened without the ones on accounts you are a team member of.
287
-
288
- </details>
289
- <details>
290
- <summary>shipments (4)</summary>
291
-
292
- Mirrors the filtering query params of `GET /api/v1/shipments`.
293
-
294
- - `created_after` `string` — Return shipments created after this ISO 8601 timestamp.
295
- - `created_before` `string` — Return shipments created before this ISO 8601 timestamp.
296
- - `payment_id` `string[]` — Only shipments fulfilling these payments, each prefixed `pay_`. Repeat the parameter to pass several, up to 100 per request — one paginated list covers all of them.
297
- - `status` `string` — Filter to shipments with this delivery status. One of `unknown`, `pre_transit`, `in_transit`, `out_for_delivery`, `delivered`, `available_for_pickup`, `return_to_sender`, `failure`, `cancelled`, `error`.
298
-
299
- </details>
300
- <details>
301
- <summary>social_accounts (4)</summary>
302
-
303
- Mirrors the filtering query params of `GET /api/v1/social_accounts`.
304
-
305
- - `platform` `string` — Only return social accounts for the platform that is specified. One of `x`, `instagram`, `youtube`, `tiktok`, `facebook`, `discord`, `telegram`.
306
- - `scopes` `string[]` — Only return social accounts that have these scopes.
307
- - `user_id` `string` — The User that the social accounts are connected to. Provide either this or account_id.
308
- - `verified` `boolean` — Only return social accounts that are verified on the platform.
309
-
310
- </details>
311
- <details>
312
- <summary>team_members (5)</summary>
313
-
314
- Mirrors the filtering query params of `GET /api/v1/team_members`.
315
-
316
- - `created_after` `string` — Only return members added after this ISO 8601 timestamp.
317
- - `created_before` `string` — Only return members added before this ISO 8601 timestamp.
318
- - `role` `string` — Only return members with this role. `custom` matches members on a dashboard-managed custom role. One of `owner`, `admin`, `sales_manager`, `moderator`, `advertiser`, `app_manager`, `support`, `manager`, `workforce`, `custom`.
319
- - `status` `string` — Only return members with this status: `joined` (accepted members) or `pending` (pending invites). Both are returned by default. One of `joined`, `pending`.
320
- - `user_id` `string` — Only return the membership for this user ID, prefixed `user_`.
321
-
322
- </details>
323
- <details>
324
- <summary>transfers (4)</summary>
325
-
326
- Mirrors the filtering query params of `GET /api/v1/transfers`.
327
-
328
- - `created_after` `string` — Only transfers created strictly after this ISO 8601 timestamp.
329
- - `created_before` `string` — Only transfers created strictly before this ISO 8601 timestamp.
330
- - `destination_id` `string` — Filter to transfers received by this account. Provide this or origin_id.
331
- - `origin_id` `string` — Filter to transfers sent from this account. Provide this or destination_id.
332
-
333
- </details>
334
- <details>
335
- <summary>webhooks (3)</summary>
336
-
337
- Mirrors the filtering query params of `GET /api/v1/webhooks`.
338
-
339
- - `app_id` `string` — Only return webhooks attached to this app. Omit to list the account's own webhooks.
340
- - `has_failures` `boolean` — Only return webhooks whose endpoint is currently failing — every delivery since the current failure streak began has been rejected. Clears as soon as a delivery succeeds.
341
- - `include_app_webhooks` `boolean` — Also return webhooks attached to the account's apps, not just the account's own. Cannot be combined with `app_id`.
342
-
343
- </details>
344
- </details> |
345
- | `--resource` | `string` | yes | | The resource to export, e.g. `payouts`, `receipts`, or `members`. |
346
- | `--timezone` | `string` | no | | IANA timezone for date columns, e.g. `America/New_York`. Defaults to `UTC`. |
347
- | `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
348
-
349
- > Confirm with the user before executing this destructive command.
350
-
351
- ---
352
-
353
- # whop exports get
354
-
355
- Retrieve Export
356
-
357
- ## Arguments
358
-
359
- | Name | Type | Required | Description |
360
- |------|------|----------|-------------|
361
- | `id` | `string` | yes | The export ID, prefixed `exprt_`. |
362
-
363
- ---
364
-
365
- # whop exports list
366
-
367
- List Exports
368
-
369
- ## Options
370
-
371
- | Flag | Type | Required | Default | Description |
372
- |------|------|----------|---------|-------------|
373
- | `--account_id` | `string` | no | | The account to list exports for, prefixed `biz_`. Defaults to the credential's account. |
374
- | `--resource` | `string` | no | | Only return exports of this resource. |
375
- | `--status` | `string` | no | | Only return exports in this status. |
376
- | `--created_after` | `string` | no | | Only return exports created at or after this ISO 8601 timestamp. |
377
- | `--created_before` | `string` | no | | Only return exports created at or before this ISO 8601 timestamp. |
378
- | `--order` | `string` | no | | The field to sort by. |
379
- | `--direction` | `string` | no | | The sort direction. |
@@ -1,52 +0,0 @@
1
- ---
2
- name: whop-ledgers
3
- description: The activity feed behind an account or user's balance. Run `whop ledgers --help` for usage details.
4
- requires_bin: whop
5
- command: whop ledgers
6
- ---
7
-
8
- A Ledger Activity row is a single financial event on an account's ledger — a payment, withdrawal, refund, transfer, on-chain deposit, swap, or card transaction. Each row is derived from the underlying ledger lines and carries a typed `resource` and `source` so you can present and link the event without extra lookups.
9
-
10
- Use Ledger Activity to build a statement or transaction feed for an account or user. Reconcile against your own records with `amount` (signed, in the currency's smallest precision units) and `posted_at`, and use `available_at` to know when inflows became withdrawable.
11
-
12
- # whop ledgers list
13
-
14
- List Financial Activity
15
-
16
- ## Options
17
-
18
- | Flag | Type | Required | Default | Description |
19
- |------|------|----------|---------|-------------|
20
- | `--account_id` | `string` | no | | The owning account ID (a biz_ identifier). Provide this or user_id. |
21
- | `--user_id` | `string` | no | | The owning user ID (a user_ identifier). Provide this or account_id. |
22
- | `--include_owned_accounts` | `boolean` | no | | When true, aggregates the authenticated user's personal ledger with the businesses they own (owner role with balance read) into one feed. Requires user_id to be the authenticated user; cannot be combined with account_id or the settlement-date filters. Each returned row includes the owning `account`. |
23
- | `--include_resource` | `boolean` | no | `true` | Whether to include the `resource` field in the response or not. Consider passing `false` if you need a fast response without as many rich details. |
24
- | `--line_types` | `array` | no | | Optional ledger line categories to include. Some categories (for example `onchain_deposit`, which covers inbound crypto deposits such as MoonPay onramps) are only returned when explicitly requested here. |
25
- | `--currency` | `string` | no | | Optional currency code filter, for example `usd`. |
26
- | `--posted_after` | `string` | no | | Only include rows posted after this ISO 8601 timestamp. |
27
- | `--posted_before` | `string` | no | | Only include rows posted before this ISO 8601 timestamp. |
28
- | `--available_after` | `string` | no | | Only include rows whose funds became withdrawable on or after this `YYYY-MM-DD` settlement date (UTC), distinct from posted_at. Requires currency. |
29
- | `--available_before` | `string` | no | | Only include rows whose funds became withdrawable on or before this `YYYY-MM-DD` settlement date (UTC). Set equal to available_after for a single day. Requires currency. |
30
- | `--limit` | `number` | no | `20` | Maximum number of rows to return. |
31
- | `--cursor` | `string` | no | | Cursor returned by the previous page. |
32
-
33
- ---
34
-
35
- # whop ledgers report
36
-
37
- Get Financial Report
38
-
39
- ## Options
40
-
41
- | Flag | Type | Required | Default | Description |
42
- |------|------|----------|---------|-------------|
43
- | `--account_id` | `string` | no | | The owning account ID (a biz_ identifier), or `global` for a platform-wide report across all ledger accounts (requires internal admin access). |
44
- | `--report_type` | `string` | yes | | The type of financial report to generate. |
45
- | `--currency` | `string` | no | | Filter rows to this currency, for example `usd`. Defaults to `usd` unless `in_currency` is provided. |
46
- | `--in_currency` | `string` | no | | Aggregate all activity into this display currency via FX conversion. |
47
- | `--from_date` | `string` | no | | Start of the report window as an ISO 8601 timestamp (UTC). Required for platform-wide (global) reports. |
48
- | `--to_date` | `string` | no | | End of the report window as an ISO 8601 timestamp (UTC). Required for platform-wide (global) reports. |
49
- | `--group_by` | `string` | no | | Grouping granularity for report rows. |
50
- | `--timezone` | `string` | no | | IANA timezone (for example `America/New_York`) used to bucket report periods and to interpret calendar-day boundaries for balance snapshots. Defaults to UTC. from_date/to_date remain exact instants regardless of this setting. |
51
- | `--cumulative` | `boolean` | no | `false` | Platform-wide (global) reports only: when true, return cumulative balances as of to_date (all history, no lower bound) instead of activity within the period. |
52
- | `--scope_account_id` | `string` | no | | Platform-wide (global) reports only: narrow the report to ledger lines on the ledger account owned by this account ID (a biz_ identifier). Ignored unless account_id is `global`. |