@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.
- package/README.md +17 -3
- package/dist/index.js +6647 -15750
- package/dist/index.js.map +1 -1
- package/dist/vite-devtools-stub.d.ts +22 -0
- package/dist/vite-devtools-stub.js +19 -0
- package/dist/vite-devtools-stub.js.map +1 -0
- package/dist/vite.d.ts +17 -2
- package/dist/vite.js +30 -5
- package/dist/vite.js.map +1 -1
- package/package.json +8 -7
- 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,233 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: whop-resolution-center-cases
|
|
3
|
-
description: File or respond to a case against a payment, as the buyer or the merchant. Run `whop resolution-center-cases --help` for usage details.
|
|
4
|
-
requires_bin: whop
|
|
5
|
-
command: whop resolution-center-cases
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
A Resolution Center Case is opened by a buyer when something is wrong with a purchase — an unwanted renewal, an item that never arrived, or a charge they don't recognize. It is the step before a chargeback: the two sides work it out directly, and Whop decides the case if they can't. Each case carries a reason, a status naming which side it is waiting on, a timeline of events, and the actions available to whoever is reading it.
|
|
9
|
-
|
|
10
|
-
Use the Resolution Center Cases API from either side: as the buyer, open a case, reply, appeal a decision, or withdraw it; as the merchant, accept it (refunding the payment), deny it, or ask the buyer for more information. Both sides read the same case, page its timeline, and summarize the cases they can see.
|
|
11
|
-
|
|
12
|
-
# whop resolution-center-cases accept
|
|
13
|
-
|
|
14
|
-
Accept a Case
|
|
15
|
-
|
|
16
|
-
## Arguments
|
|
17
|
-
|
|
18
|
-
| Name | Type | Required | Description |
|
|
19
|
-
|------|------|----------|-------------|
|
|
20
|
-
| `id` | `string` | yes | The resolution center case ID (`reso_` tag). |
|
|
21
|
-
|
|
22
|
-
## Options
|
|
23
|
-
|
|
24
|
-
| Flag | Type | Required | Default | Description |
|
|
25
|
-
|------|------|----------|---------|-------------|
|
|
26
|
-
| `--attachments` | `array` | no | | Up to 3 evidence files, by existing file `id` or `direct_upload_id`. |
|
|
27
|
-
| `--message` | `string` | no | | An optional note to the customer, recorded on the case timeline. |
|
|
28
|
-
| `--terminate_membership` | `boolean` | no | | Whether to also terminate the customer's membership. |
|
|
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 resolution-center-cases appeal
|
|
36
|
-
|
|
37
|
-
Appeal a Case
|
|
38
|
-
|
|
39
|
-
## Arguments
|
|
40
|
-
|
|
41
|
-
| Name | Type | Required | Description |
|
|
42
|
-
|------|------|----------|-------------|
|
|
43
|
-
| `id` | `string` | yes | The resolution center case ID (`reso_` tag). |
|
|
44
|
-
|
|
45
|
-
## Options
|
|
46
|
-
|
|
47
|
-
| Flag | Type | Required | Default | Description |
|
|
48
|
-
|------|------|----------|---------|-------------|
|
|
49
|
-
| `--attachments` | `array` | no | | Up to 3 evidence files, by existing file `id` or `direct_upload_id`. |
|
|
50
|
-
| `--message` | `string` | yes | | Why you are appealing the decision. |
|
|
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 resolution-center-cases create
|
|
58
|
-
|
|
59
|
-
Open a Case as the Customer
|
|
60
|
-
|
|
61
|
-
## Options
|
|
62
|
-
|
|
63
|
-
| Flag | Type | Required | Default | Description |
|
|
64
|
-
|------|------|----------|---------|-------------|
|
|
65
|
-
| `--attachments` | `array` | no | | |
|
|
66
|
-
| `--message` | `string` | yes | | The customer's explanation. |
|
|
67
|
-
| `--reason` | `string` | yes | | What went wrong. Uses the same vocabulary as `/disputes`. |
|
|
68
|
-
| `--receipt_id` | `string` | yes | | The payment to open the case against (`pay_` tag). |
|
|
69
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
70
|
-
|
|
71
|
-
> Confirm with the user before executing this destructive command.
|
|
72
|
-
|
|
73
|
-
---
|
|
74
|
-
|
|
75
|
-
# whop resolution-center-cases deny
|
|
76
|
-
|
|
77
|
-
Deny a Case
|
|
78
|
-
|
|
79
|
-
## Arguments
|
|
80
|
-
|
|
81
|
-
| Name | Type | Required | Description |
|
|
82
|
-
|------|------|----------|-------------|
|
|
83
|
-
| `id` | `string` | yes | The resolution center case ID (`reso_` tag). |
|
|
84
|
-
|
|
85
|
-
## Options
|
|
86
|
-
|
|
87
|
-
| Flag | Type | Required | Default | Description |
|
|
88
|
-
|------|------|----------|---------|-------------|
|
|
89
|
-
| `--attachments` | `array` | no | | Up to 3 evidence files, by existing file `id` or `direct_upload_id`. |
|
|
90
|
-
| `--message` | `string` | yes | | Why the claim is being denied. Shown to the customer. |
|
|
91
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
92
|
-
|
|
93
|
-
> Confirm with the user before executing this destructive command.
|
|
94
|
-
|
|
95
|
-
---
|
|
96
|
-
|
|
97
|
-
# whop resolution-center-cases events
|
|
98
|
-
|
|
99
|
-
List Resolution Center Case Events
|
|
100
|
-
|
|
101
|
-
## Arguments
|
|
102
|
-
|
|
103
|
-
| Name | Type | Required | Description |
|
|
104
|
-
|------|------|----------|-------------|
|
|
105
|
-
| `id` | `string` | yes | The resolution center case ID (`reso_` tag). |
|
|
106
|
-
|
|
107
|
-
## Options
|
|
108
|
-
|
|
109
|
-
| Flag | Type | Required | Default | Description |
|
|
110
|
-
|------|------|----------|---------|-------------|
|
|
111
|
-
| `--first` | `number` | no | | The number of events to return (default 20, max 100). |
|
|
112
|
-
| `--after` | `string` | no | | A cursor; returns events after this position. |
|
|
113
|
-
| `--last` | `number` | no | | The number of events to return from the end of the range. |
|
|
114
|
-
| `--before` | `string` | no | | A cursor; returns events before this position. |
|
|
115
|
-
|
|
116
|
-
---
|
|
117
|
-
|
|
118
|
-
# whop resolution-center-cases get
|
|
119
|
-
|
|
120
|
-
Retrieve Resolution Center Case
|
|
121
|
-
|
|
122
|
-
## Arguments
|
|
123
|
-
|
|
124
|
-
| Name | Type | Required | Description |
|
|
125
|
-
|------|------|----------|-------------|
|
|
126
|
-
| `id` | `string` | yes | The resolution center case ID (`reso_` tag). |
|
|
127
|
-
|
|
128
|
-
---
|
|
129
|
-
|
|
130
|
-
# whop resolution-center-cases list
|
|
131
|
-
|
|
132
|
-
List Resolution Center Cases
|
|
133
|
-
|
|
134
|
-
## Options
|
|
135
|
-
|
|
136
|
-
| Flag | Type | Required | Default | Description |
|
|
137
|
-
|------|------|----------|---------|-------------|
|
|
138
|
-
| `--account_id` | `string` | no | | Only cases filed against this account (`biz_` tag). With read access to the account this lists its whole queue; without, only the cases you opened against it. |
|
|
139
|
-
| `--user_id` | `string` | no | | 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. |
|
|
140
|
-
| `--first` | `number` | no | | The number of cases to return (default 20, max 100). |
|
|
141
|
-
| `--after` | `string` | no | | A cursor; returns cases after this position. |
|
|
142
|
-
| `--last` | `number` | no | | The number of cases to return from the end of the range. |
|
|
143
|
-
| `--before` | `string` | no | | A cursor; returns cases before this position. |
|
|
144
|
-
| `--order` | `string` | no | | The field to sort cases by. |
|
|
145
|
-
| `--direction` | `string` | no | | Sort direction. |
|
|
146
|
-
| `--status` | `array` | no | | Only cases in these statuses. Repeat the parameter to pass several — one paginated list covers all of them. |
|
|
147
|
-
| `--reason` | `array` | no | | Only cases opened for these reasons. Repeat the parameter to pass several. |
|
|
148
|
-
| `--outcome` | `array` | no | | Only closed cases that ended these ways. Repeat the parameter to pass several. |
|
|
149
|
-
| `--created_before` | `string` | no | | Only cases created before this ISO 8601 timestamp. |
|
|
150
|
-
| `--created_after` | `string` | no | | Only cases created after this ISO 8601 timestamp. |
|
|
151
|
-
|
|
152
|
-
---
|
|
153
|
-
|
|
154
|
-
# whop resolution-center-cases reply
|
|
155
|
-
|
|
156
|
-
Reply to a Case
|
|
157
|
-
|
|
158
|
-
## Arguments
|
|
159
|
-
|
|
160
|
-
| Name | Type | Required | Description |
|
|
161
|
-
|------|------|----------|-------------|
|
|
162
|
-
| `id` | `string` | yes | The resolution center case ID (`reso_` tag). |
|
|
163
|
-
|
|
164
|
-
## Options
|
|
165
|
-
|
|
166
|
-
| Flag | Type | Required | Default | Description |
|
|
167
|
-
|------|------|----------|---------|-------------|
|
|
168
|
-
| `--attachments` | `array` | no | | Up to 3 evidence files, by existing file `id` or `direct_upload_id`. |
|
|
169
|
-
| `--message` | `string` | yes | | The reply to add to the case. |
|
|
170
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
171
|
-
|
|
172
|
-
> Confirm with the user before executing this destructive command.
|
|
173
|
-
|
|
174
|
-
---
|
|
175
|
-
|
|
176
|
-
# whop resolution-center-cases request_info
|
|
177
|
-
|
|
178
|
-
Request Information from the Customer
|
|
179
|
-
|
|
180
|
-
## Arguments
|
|
181
|
-
|
|
182
|
-
| Name | Type | Required | Description |
|
|
183
|
-
|------|------|----------|-------------|
|
|
184
|
-
| `id` | `string` | yes | The resolution center case ID (`reso_` tag). |
|
|
185
|
-
|
|
186
|
-
## Options
|
|
187
|
-
|
|
188
|
-
| Flag | Type | Required | Default | Description |
|
|
189
|
-
|------|------|----------|---------|-------------|
|
|
190
|
-
| `--attachments` | `array` | no | | Up to 3 evidence files, by existing file `id` or `direct_upload_id`. |
|
|
191
|
-
| `--message` | `string` | no | | What you need from the customer. |
|
|
192
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
193
|
-
|
|
194
|
-
> Confirm with the user before executing this destructive command.
|
|
195
|
-
|
|
196
|
-
---
|
|
197
|
-
|
|
198
|
-
# whop resolution-center-cases summary
|
|
199
|
-
|
|
200
|
-
Retrieve Resolution Center Case Summary
|
|
201
|
-
|
|
202
|
-
## Options
|
|
203
|
-
|
|
204
|
-
| Flag | Type | Required | Default | Description |
|
|
205
|
-
|------|------|----------|---------|-------------|
|
|
206
|
-
| `--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. |
|
|
207
|
-
| `--account_id` | `string` | no | | The account to summarize cases for (`biz_` tag). |
|
|
208
|
-
| `--user_id` | `string` | no | | Only cases opened by this customer — a `user_` tag, or `me` for the calling user. |
|
|
209
|
-
| `--status` | `array` | no | | Only cases in these statuses. |
|
|
210
|
-
| `--reason` | `array` | no | | Only cases opened for these reasons. |
|
|
211
|
-
| `--outcome` | `array` | no | | Only closed cases that ended these ways. |
|
|
212
|
-
| `--created_before` | `string` | no | | Only count cases created before this ISO 8601 timestamp. |
|
|
213
|
-
| `--created_after` | `string` | no | | Only count cases created after this ISO 8601 timestamp. |
|
|
214
|
-
|
|
215
|
-
---
|
|
216
|
-
|
|
217
|
-
# whop resolution-center-cases withdraw
|
|
218
|
-
|
|
219
|
-
Withdraw a Case
|
|
220
|
-
|
|
221
|
-
## Arguments
|
|
222
|
-
|
|
223
|
-
| Name | Type | Required | Description |
|
|
224
|
-
|------|------|----------|-------------|
|
|
225
|
-
| `id` | `string` | yes | The resolution center case ID (`reso_` tag). |
|
|
226
|
-
|
|
227
|
-
## Options
|
|
228
|
-
|
|
229
|
-
| Flag | Type | Required | Default | Description |
|
|
230
|
-
|------|------|----------|---------|-------------|
|
|
231
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
232
|
-
|
|
233
|
-
> Confirm with the user before executing this destructive command.
|
|
@@ -1,40 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: whop-setup-intents
|
|
3
|
-
description: Saving a buyer's payment method without charging it. Run `whop setup-intents --help` for usage details.
|
|
4
|
-
requires_bin: whop
|
|
5
|
-
command: whop setup-intents
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
A Setup Intent saves a buyer's payment method for later without taking money now. It runs the same collection flow a payment does, so the buyer may still owe a step — 3D Secure on a card, a hosted enrollment, or linking a bank account.
|
|
9
|
-
|
|
10
|
-
Poll [Retrieve status](https://docs.whop.com/api-reference/beta/setup-intents/retrieve-status) for how far the setup has got and what is outstanding. Once it reaches `succeeded` the method is on file and can be charged.
|
|
11
|
-
|
|
12
|
-
# whop setup-intents return_url
|
|
13
|
-
|
|
14
|
-
Update setup return URL
|
|
15
|
-
|
|
16
|
-
## Arguments
|
|
17
|
-
|
|
18
|
-
| Name | Type | Required | Description |
|
|
19
|
-
|------|------|----------|-------------|
|
|
20
|
-
| `setup_intent_id` | `string` | yes | The unique identifier of the setup intent. |
|
|
21
|
-
|
|
22
|
-
## Options
|
|
23
|
-
|
|
24
|
-
| Flag | Type | Required | Default | Description |
|
|
25
|
-
|------|------|----------|---------|-------------|
|
|
26
|
-
| `--return_url` | `string` | yes | | Where the buyer continues after completing an off-site step. Must be an absolute https URL without credentials (http is allowed for localhost), at most 2,048 characters. |
|
|
27
|
-
|
|
28
|
-
> Confirm with the user before executing this destructive command.
|
|
29
|
-
|
|
30
|
-
---
|
|
31
|
-
|
|
32
|
-
# whop setup-intents status
|
|
33
|
-
|
|
34
|
-
Retrieve setup status
|
|
35
|
-
|
|
36
|
-
## Arguments
|
|
37
|
-
|
|
38
|
-
| Name | Type | Required | Description |
|
|
39
|
-
|------|------|----------|-------------|
|
|
40
|
-
| `setup_intent_id` | `string` | yes | The unique identifier of the setup intent. |
|
|
@@ -1,79 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: whop-shipments
|
|
3
|
-
description: Track the delivery of an order by its carrier tracking number. Run `whop shipments --help` for usage details.
|
|
4
|
-
requires_bin: whop
|
|
5
|
-
command: whop shipments
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
A Shipment attaches a carrier tracking number to a payment and follows the package from label creation to delivery, exposing the current delivery status and a customer-facing tracking URL.
|
|
9
|
-
|
|
10
|
-
Use the Shipments API to list an account's shipments, retrieve one by its id or the payment it fulfills, attach a tracking number to a payment, and update the tracking number on an existing shipment.
|
|
11
|
-
|
|
12
|
-
# whop shipments create
|
|
13
|
-
|
|
14
|
-
Create Shipment
|
|
15
|
-
|
|
16
|
-
## Options
|
|
17
|
-
|
|
18
|
-
| Flag | Type | Required | Default | Description |
|
|
19
|
-
|------|------|----------|---------|-------------|
|
|
20
|
-
| `--account_id` | `string` | no | | The unique identifier of the account, prefixed `biz_`. |
|
|
21
|
-
| `--payment_id` | `string` | yes | | The payment to attach the shipment to, prefixed `pay_`. |
|
|
22
|
-
| `--tracking_number` | `string` | yes | | The carrier-assigned tracking number. |
|
|
23
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
24
|
-
|
|
25
|
-
> Confirm with the user before executing this destructive command.
|
|
26
|
-
|
|
27
|
-
---
|
|
28
|
-
|
|
29
|
-
# whop shipments get
|
|
30
|
-
|
|
31
|
-
Retrieve Shipment
|
|
32
|
-
|
|
33
|
-
## Arguments
|
|
34
|
-
|
|
35
|
-
| Name | Type | Required | Description |
|
|
36
|
-
|------|------|----------|-------------|
|
|
37
|
-
| `id` | `string` | yes | The shipment id (`ship_`), or the payment id (`pay_`) it fulfills. |
|
|
38
|
-
|
|
39
|
-
---
|
|
40
|
-
|
|
41
|
-
# whop shipments list
|
|
42
|
-
|
|
43
|
-
List Shipments
|
|
44
|
-
|
|
45
|
-
## Options
|
|
46
|
-
|
|
47
|
-
| Flag | Type | Required | Default | Description |
|
|
48
|
-
|------|------|----------|---------|-------------|
|
|
49
|
-
| `--account_id` | `string` | no | | The account to list shipments for. Defaults to the acting account. |
|
|
50
|
-
| `--status` | `string` | no | | Filter to shipments with this delivery status. |
|
|
51
|
-
| `--payment_id` | `array` | no | | 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. |
|
|
52
|
-
| `--created_before` | `string` | no | | Return shipments created before this ISO 8601 timestamp. |
|
|
53
|
-
| `--created_after` | `string` | no | | Return shipments created after this ISO 8601 timestamp. |
|
|
54
|
-
| `--order` | `string` | no | | The field to sort by. |
|
|
55
|
-
| `--direction` | `string` | no | | The sort direction. |
|
|
56
|
-
| `--first` | `number` | no | | The number of shipments to return. |
|
|
57
|
-
| `--after` | `string` | no | | A cursor; returns shipments after this position. |
|
|
58
|
-
| `--last` | `number` | no | | The number of shipments to return from the end of the range. |
|
|
59
|
-
| `--before` | `string` | no | | A cursor; returns shipments before this position. |
|
|
60
|
-
|
|
61
|
-
---
|
|
62
|
-
|
|
63
|
-
# whop shipments update
|
|
64
|
-
|
|
65
|
-
Update Shipment
|
|
66
|
-
|
|
67
|
-
## Arguments
|
|
68
|
-
|
|
69
|
-
| Name | Type | Required | Description |
|
|
70
|
-
|------|------|----------|-------------|
|
|
71
|
-
| `id` | `string` | yes | The shipment id (`ship_`), or the payment id (`pay_`) it fulfills. |
|
|
72
|
-
|
|
73
|
-
## Options
|
|
74
|
-
|
|
75
|
-
| Flag | Type | Required | Default | Description |
|
|
76
|
-
|------|------|----------|---------|-------------|
|
|
77
|
-
| `--tracking_number` | `string` | yes | | The new carrier-assigned tracking number. |
|
|
78
|
-
|
|
79
|
-
> Confirm with the user before executing this destructive command.
|
|
@@ -1,128 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: whop-social-accounts
|
|
3
|
-
description: Connected Facebook and Instagram accounts that run ads. Run `whop social-accounts --help` for usage details.
|
|
4
|
-
requires_bin: whop
|
|
5
|
-
command: whop social-accounts
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
A Social Account represents an external profile connected to a Whop account or user, such as a Facebook page or Instagram account. Connecting a social account lets Whop run [ads](https://docs.whop.com/api-reference/beta/ads/ad) under that profile's identity and promote its existing posts.
|
|
9
|
-
|
|
10
|
-
Use the Social Accounts API to list connected accounts, create a Whop-managed Facebook page, start an OAuth connection, disconnect a social account, and list a connected profile's posts or a Facebook page's lead forms.
|
|
11
|
-
|
|
12
|
-
# whop social-accounts connect
|
|
13
|
-
|
|
14
|
-
Connect a Social Account
|
|
15
|
-
|
|
16
|
-
## Options
|
|
17
|
-
|
|
18
|
-
| Flag | Type | Required | Default | Description |
|
|
19
|
-
|------|------|----------|---------|-------------|
|
|
20
|
-
| `--account_id` | `string` | no | | The Account (biz_ identifier) to connect the social account for. An account-scoped API key may omit this to default to its own account. |
|
|
21
|
-
| `--platform` | `string` | yes | | The platform to connect the social account on. Supported options are `meta_business` and `tiktok`. |
|
|
22
|
-
| `--redirect_url` | `string` | no | | The Whop URL to redirect the user to after they finish connecting. |
|
|
23
|
-
| `--scopes` | `array` | no | | Capabilities to grant for the connected social account. Use `advertise` when connecting a Meta Business or TikTok account for ads. |
|
|
24
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
25
|
-
|
|
26
|
-
> Confirm with the user before executing this destructive command.
|
|
27
|
-
|
|
28
|
-
---
|
|
29
|
-
|
|
30
|
-
# whop social-accounts create
|
|
31
|
-
|
|
32
|
-
Create a Social Account
|
|
33
|
-
|
|
34
|
-
## Options
|
|
35
|
-
|
|
36
|
-
| Flag | Type | Required | Default | Description |
|
|
37
|
-
|------|------|----------|---------|-------------|
|
|
38
|
-
| `--account_id` | `string` | no | | The Account (biz_ identifier) to create the social account for. An account-scoped API key may omit this to default to its own account. Account API keys cannot update their own account's branding through Update Account; use a user-authenticated path. |
|
|
39
|
-
| `--platform` | `string` | yes | | The platform to create the social account on. `facebook` requires the account's `banner_image`, `logo`, and `description`; configure them with [Update Account](/api-reference/beta/accounts/update-account). |
|
|
40
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
41
|
-
|
|
42
|
-
> Confirm with the user before executing this destructive command.
|
|
43
|
-
|
|
44
|
-
---
|
|
45
|
-
|
|
46
|
-
# whop social-accounts delete
|
|
47
|
-
|
|
48
|
-
Delete a Social Account
|
|
49
|
-
|
|
50
|
-
## Arguments
|
|
51
|
-
|
|
52
|
-
| Name | Type | Required | Description |
|
|
53
|
-
|------|------|----------|-------------|
|
|
54
|
-
| `id` | `string` | yes | The ID of the social account to disconnect. |
|
|
55
|
-
|
|
56
|
-
## Options
|
|
57
|
-
|
|
58
|
-
| Flag | Type | Required | Default | Description |
|
|
59
|
-
|------|------|----------|---------|-------------|
|
|
60
|
-
| `--account_id` | `string` | no | | The Account that the social account is connected to. Provide either this or user_id. |
|
|
61
|
-
| `--user_id` | `string` | no | | The User that the social account is connected to. Provide either this or account_id. |
|
|
62
|
-
|
|
63
|
-
> Confirm with the user before executing this destructive command.
|
|
64
|
-
|
|
65
|
-
---
|
|
66
|
-
|
|
67
|
-
# whop social-accounts lead_forms
|
|
68
|
-
|
|
69
|
-
List Social Account Lead Forms
|
|
70
|
-
|
|
71
|
-
## Arguments
|
|
72
|
-
|
|
73
|
-
| Name | Type | Required | Description |
|
|
74
|
-
|------|------|----------|-------------|
|
|
75
|
-
| `id` | `string` | yes | The social account (a sacc_ identifier) whose lead forms to list. |
|
|
76
|
-
|
|
77
|
-
## Options
|
|
78
|
-
|
|
79
|
-
| Flag | Type | Required | Default | Description |
|
|
80
|
-
|------|------|----------|---------|-------------|
|
|
81
|
-
| `--account_id` | `string` | no | | The Account (a biz_ identifier) the social account is connected to. |
|
|
82
|
-
|
|
83
|
-
---
|
|
84
|
-
|
|
85
|
-
# whop social-accounts list
|
|
86
|
-
|
|
87
|
-
List Social Accounts
|
|
88
|
-
|
|
89
|
-
## Options
|
|
90
|
-
|
|
91
|
-
| Flag | Type | Required | Default | Description |
|
|
92
|
-
|------|------|----------|---------|-------------|
|
|
93
|
-
| `--account_id` | `string` | no | | The Account that the social accounts are connected to. Provide either this or user_id. |
|
|
94
|
-
| `--user_id` | `string` | no | | The User that the social accounts are connected to. Provide either this or account_id. |
|
|
95
|
-
| `--platform` | `string` | no | | Only return social accounts for the platform that is specified. |
|
|
96
|
-
| `--verified` | `boolean` | no | | Only return social accounts that are verified on the platform. |
|
|
97
|
-
| `--scopes` | `array` | no | | Only return social accounts that have these scopes. |
|
|
98
|
-
| `--first` | `number` | no | `20` | The number of social accounts to return. |
|
|
99
|
-
| `--after` | `string` | no | | Cursor to fetch the page after (from page_info.end_cursor). |
|
|
100
|
-
| `--last` | `number` | no | | The number of social accounts to return from the end of the range. |
|
|
101
|
-
| `--before` | `string` | no | | Cursor to fetch the page before (from page_info.start_cursor). |
|
|
102
|
-
| `--order` | `string` | no | | The field to sort social accounts by. |
|
|
103
|
-
| `--direction` | `string` | no | | Sort direction. |
|
|
104
|
-
|
|
105
|
-
---
|
|
106
|
-
|
|
107
|
-
# whop social-accounts posts
|
|
108
|
-
|
|
109
|
-
List Social Account Posts
|
|
110
|
-
|
|
111
|
-
## Arguments
|
|
112
|
-
|
|
113
|
-
| Name | Type | Required | Description |
|
|
114
|
-
|------|------|----------|-------------|
|
|
115
|
-
| `id` | `string` | yes | The social account (a sacc_ identifier) whose posts to list. |
|
|
116
|
-
|
|
117
|
-
## Options
|
|
118
|
-
|
|
119
|
-
| Flag | Type | Required | Default | Description |
|
|
120
|
-
|------|------|----------|---------|-------------|
|
|
121
|
-
| `--account_id` | `string` | no | | The Account (a biz_ identifier) the social account is connected to. |
|
|
122
|
-
| `--post_id` | `string` | no | | Return only the single post with this platform id, instead of the full list. |
|
|
123
|
-
| `--first` | `number` | no | `20` | The number of posts to return. |
|
|
124
|
-
| `--after` | `string` | no | | Cursor to fetch the page after (from page_info.end_cursor). |
|
|
125
|
-
|
|
126
|
-
## Steps that finish in the browser
|
|
127
|
-
|
|
128
|
-
Some commands respond with a URL the user must open in a browser to finish the flow (`authorize_url`, `session_url`, `deposit_url`, `checkout_url`) — the CLI cannot complete that step itself. When a response contains one of these fields, or the CLI prints "Action required: open this link in the user's browser", open that link in the user's browser for them, tell them what to complete there, then re-run the matching `get`/`list` command to confirm the step finished.
|
|
@@ -1,65 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: whop-stats
|
|
3
|
-
description: Aggregated financial, audience, and traffic reporting. Run `whop stats --help` for usage details.
|
|
4
|
-
requires_bin: whop
|
|
5
|
-
command: whop stats
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
Stats represent aggregated activity for an account over time. They help you understand revenue, transactions, disputes, members, referrals, and advertising performance across reporting periods like days, weeks, or months.
|
|
9
|
-
|
|
10
|
-
Use the Stats API to list available metrics and their filterable properties, then retrieve time-series values for a date range.
|
|
11
|
-
|
|
12
|
-
# whop stats get
|
|
13
|
-
|
|
14
|
-
Retrieve Metric
|
|
15
|
-
|
|
16
|
-
## Arguments
|
|
17
|
-
|
|
18
|
-
| Name | Type | Required | Description |
|
|
19
|
-
|------|------|----------|-------------|
|
|
20
|
-
| `metric` | `string` | yes | The metric to retrieve, for example net_revenue. Use GET /stats to see every metric key. The metric sets the unit and the properties you can filter or break down by. |
|
|
21
|
-
|
|
22
|
-
## Options
|
|
23
|
-
|
|
24
|
-
| Flag | Type | Required | Default | Description |
|
|
25
|
-
|------|------|----------|---------|-------------|
|
|
26
|
-
| `--account_id` | `string` | no | | The account this query concerns, for example biz_AbC123. |
|
|
27
|
-
| `--user_id` | `string` | no | | The user this query concerns, for example user_AbC123. Available on metrics that support user subjects, such as account_balance. |
|
|
28
|
-
| `--from` | `string` | yes | | Start of the range — a date (YYYY-MM-DD), expanded to the start of that day, or an ISO 8601 timestamp (for example 2026-07-16T16:37:00Z), used exactly. |
|
|
29
|
-
| `--to` | `string` | yes | | End of the range — a date (YYYY-MM-DD), expanded to the end of that day, or an ISO 8601 timestamp (for example 2026-07-17T16:37:00Z), used exactly. |
|
|
30
|
-
| `--interval` | `string` | no | | How wide each point is. Defaults to day. Snapshot metrics are day-only. |
|
|
31
|
-
| `--breakdown_by` | `string` | no | | Split the metric out by one of its properties — each point gets a breakdown array. For example breakdown_by=currency returns an entry for usd, an entry for eur, and so on. |
|
|
32
|
-
| `--convert_to` | `string` | no | | Display currency for money metrics — every amount is converted into this ISO currency using the exchange rate on each period's date. Defaults to usd. For the ads metrics (ad_spend, ad_delivery), pass the account's ads reporting currency to match the ad entity endpoints. On transaction metrics, it is ignored when you filter or break down by currency (those report the original transaction currency, unconverted). |
|
|
33
|
-
| `--currency` | `string` | no | | Select the source currency or asset on metrics that list currency. For transaction metrics, for example currency=eur, values are reported without conversion. For market_prices, use btc or xaut and convert_to=usd. Pair with breakdown_by=currency to split a metric by currency. |
|
|
34
|
-
| `--time_zone` | `string` | no | | IANA time zone to bucket the series in, for example America/New_York. Defaults to UTC. Not accepted by snapshot metrics, which are UTC only. |
|
|
35
|
-
| `--payment_method` | `string` | no | | Filter to a single payment method, for example card or crypto. Available on metrics that list payment_method. |
|
|
36
|
-
| `--card_network` | `string` | no | | Filter to a single card brand, for example visa. A refinement of payment_method=card. Available on metrics that list card_network. |
|
|
37
|
-
| `--dispute_reason` | `string` | no | | Filter disputes to a normalized reason, for example product_not_received. Pair with breakdown_by=dispute_reason to split dispute counts by reason. |
|
|
38
|
-
| `--source` | `string` | no | | Filter to a single GMV source, for example payments — or, on the traffic metrics, a visit source (whop_ads, direct, or a utm_source value). Pair with breakdown_by=source to split by source. Available on metrics that list source. |
|
|
39
|
-
| `--hostname` | `string` | no | | Filter traffic metrics to one website hostname, for example shop.example.com. Pair with breakdown_by=hostname to split by website. |
|
|
40
|
-
| `--page` | `string` | no | | Filter traffic metrics to one page — a hostname plus normalized path, for example shop.example.com/pricing. Pair with breakdown_by=page to split by page. |
|
|
41
|
-
| `--device_type` | `string` | no | | Filter traffic metrics to one device type: desktop, mobile, tablet, or unknown. Pair with breakdown_by=device_type to split by device. |
|
|
42
|
-
| `--country_code` | `string` | no | | Filter traffic metrics to one visitor country (uppercase ISO 3166-1 alpha-2, for example US). Pair with breakdown_by=country_code to split by country. |
|
|
43
|
-
| `--event_name` | `string` | no | | Filter the events metric to one tracked event name, for example pixel.page or pixel.custom. Pair with breakdown_by=event_name to split by event. |
|
|
44
|
-
| `--event_type` | `string` | no | | Filter the events metric to a canonical group of events: page_view (pixel page views plus whop.com store views), checkout_start (hosted and embedded checkout views), or other. Pair with breakdown_by=event_type to split by group. |
|
|
45
|
-
| `--custom_name` | `string` | no | | Filter the events metric to one merchant-defined custom event name. Only valid alongside event_name=pixel.custom. Pair with breakdown_by=custom_name to split custom events by name. |
|
|
46
|
-
| `--segment` | `string` | no | | Filter to a single wallet-balance segment, for example available. Pair with breakdown_by=segment to split the balance. Available on metrics that list segment. |
|
|
47
|
-
| `--category` | `string` | no | | Filter to a single balance-activity category, for example payments. Pair with breakdown_by=category to split the activity. Available on metrics that list category. |
|
|
48
|
-
| `--merchant` | `string` | no | | Filter to a single cashback merchant bucket, for example whop-ads. Pair with breakdown_by=merchant to split cashback by merchant. Available on metrics that list merchant. |
|
|
49
|
-
| `--fee_type` | `string` | no | | Filter to a single fee type. Pair with breakdown_by=fee_type to split fees by type. Available on metrics that list fee_type. |
|
|
50
|
-
| `--product` | `string` | no | | Filter to a single product (access pass id), for example prod_AbC123. Pair with breakdown_by=product. Available on metrics that list product. |
|
|
51
|
-
| `--status` | `string` | no | | Filter to a single membership status. Pair with breakdown_by=status. Available on metrics that list status. |
|
|
52
|
-
| `--access_level` | `string` | no | | Filter to a single access level. Pair with breakdown_by=access_level. Available on metrics that list access_level. |
|
|
53
|
-
| `--most_recent_action` | `string` | no | | Filter to a single most-recent member action. Pair with breakdown_by=most_recent_action. Available on metrics that list most_recent_action. |
|
|
54
|
-
| `--referred_user_id` | `string` | no | | Filter a referral metric to the businesses attributed to one person you referred, for example user_AbC123. Available on metrics that list referred_user_id. |
|
|
55
|
-
| `--ad_campaign_ids` | `array` | no | | Ad campaign ids (adcamp_...) to scope the report to; stats are summed across them. Available on metrics that list ad_campaign_ids. |
|
|
56
|
-
| `--ad_group_ids` | `array` | no | | Ad group ids (adgrp_...) to scope the report to; stats are summed across them. Available on metrics that list ad_group_ids. |
|
|
57
|
-
| `--ad_ids` | `array` | no | | Ad ids (ad_...) to scope the report to; stats are summed across them. Available on metrics that list ad_ids. |
|
|
58
|
-
| `--snapshot_window` | `string` | no | | Window used by a snapshot metric. Ordinary snapshots accept 30d as their trailing activity window. Cohorted dispute metrics accept 7d or 28d as the sales-transaction pool; their attribution window is fixed in the metric name. Each metric lists its accepted values in the catalog. |
|
|
59
|
-
| `--event` | `string` | no | | Filter the events metric to one or more full event names, for example payment.completed or pixel.lead. Comma-separate several to break the metric down by each event. Available on metrics that list event. |
|
|
60
|
-
|
|
61
|
-
---
|
|
62
|
-
|
|
63
|
-
# whop stats list
|
|
64
|
-
|
|
65
|
-
List Metrics
|
|
@@ -1,77 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: whop-swaps
|
|
3
|
-
description: Convert a balance between currencies. Run `whop swaps --help` for usage details.
|
|
4
|
-
requires_bin: whop
|
|
5
|
-
command: whop swaps
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
Swaps convert value between supported tokens, chains, or wallet destinations for an account. A swap quote describes the expected output, fees, and approval requirements before you create the swap.
|
|
9
|
-
|
|
10
|
-
Use the Swaps API to quote a conversion, create the swap, list recent swaps, and retrieve status until the transaction completes.
|
|
11
|
-
|
|
12
|
-
# whop swaps create
|
|
13
|
-
|
|
14
|
-
Create Swap
|
|
15
|
-
|
|
16
|
-
## Options
|
|
17
|
-
|
|
18
|
-
| Flag | Type | Required | Default | Description |
|
|
19
|
-
|------|------|----------|---------|-------------|
|
|
20
|
-
| `--account_id` | `string` | yes | | Business or user account ID (biz_* / user_*). |
|
|
21
|
-
| `--amount` | `unknown` | no | | Source token amount. Required for crypto swaps. For fiat pairs: the amount of from_token to convert at the mid-market rate; omit (along with to_amount) to repay the full negative to_token balance instead. |
|
|
22
|
-
| `--from_chain` | `number` | no | | Source chain name or chain ID. Defaults to the source token's chain when omitted. |
|
|
23
|
-
| `--from_token` | `string` | yes | | Source token contract address or ticker symbol, such as "USDT". |
|
|
24
|
-
| `--slippage_bps` | `number` | no | | Maximum slippage tolerance in basis points. |
|
|
25
|
-
| `--to_amount` | `unknown` | no | | Fiat pairs only: sizes a partial repayment of the negative to_token balance, denominated in to_token. Must not exceed the debt. Mutually exclusive with amount. |
|
|
26
|
-
| `--to_chain` | `number` | no | | Destination chain name or chain ID. Defaults to the destination token's chain when omitted. |
|
|
27
|
-
| `--to_token` | `string` | yes | | Destination token contract address or ticker symbol, such as "XAUT". |
|
|
28
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
29
|
-
|
|
30
|
-
> Confirm with the user before executing this destructive command.
|
|
31
|
-
|
|
32
|
-
---
|
|
33
|
-
|
|
34
|
-
# whop swaps get
|
|
35
|
-
|
|
36
|
-
Retrieve Swap
|
|
37
|
-
|
|
38
|
-
## Arguments
|
|
39
|
-
|
|
40
|
-
| Name | Type | Required | Description |
|
|
41
|
-
|------|------|----------|-------------|
|
|
42
|
-
| `id` | `string` | yes | Swap ID returned from POST /swaps. |
|
|
43
|
-
|
|
44
|
-
---
|
|
45
|
-
|
|
46
|
-
# whop swaps quote
|
|
47
|
-
|
|
48
|
-
Create Swap Quote
|
|
49
|
-
|
|
50
|
-
## Options
|
|
51
|
-
|
|
52
|
-
| Flag | Type | Required | Default | Description |
|
|
53
|
-
|------|------|----------|---------|-------------|
|
|
54
|
-
| `--amount` | `string` | yes | | Source token amount. |
|
|
55
|
-
| `--from_address` | `unknown` | no | | Source wallet address used for the quote. |
|
|
56
|
-
| `--from_chain` | `number` | no | | Source chain name or chain ID. Defaults to the source token's chain when omitted. |
|
|
57
|
-
| `--from_token` | `string` | yes | | Source token contract address or ticker symbol, such as "USDT". |
|
|
58
|
-
| `--metadata` | `object` | no | | Metadata to include with the quote response. |
|
|
59
|
-
| `--slippage_bps` | `number` | no | | Maximum slippage tolerance in basis points. |
|
|
60
|
-
| `--to_address` | `unknown` | no | | Destination wallet address used for the quote. |
|
|
61
|
-
| `--to_chain` | `number` | no | | Destination chain name or chain ID. Defaults to the destination token's chain when omitted. |
|
|
62
|
-
| `--to_token` | `string` | yes | | Destination token contract address or ticker symbol, such as "XAUT". |
|
|
63
|
-
| `--idempotency-key` | `string` | no | | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
|
|
64
|
-
|
|
65
|
-
> Confirm with the user before executing this destructive command.
|
|
66
|
-
|
|
67
|
-
---
|
|
68
|
-
|
|
69
|
-
# whop swaps status
|
|
70
|
-
|
|
71
|
-
List Swaps
|
|
72
|
-
|
|
73
|
-
## Options
|
|
74
|
-
|
|
75
|
-
| Flag | Type | Required | Default | Description |
|
|
76
|
-
|------|------|----------|---------|-------------|
|
|
77
|
-
| `--account_id` | `string` | no | | Business or user account ID (biz_* / user_*). |
|