Flow reference: Plugins

SellAuth: API Request

Call any SellAuth API action 1:1 (invoices, products, coupons, customers, tickets, subscriptions…).

Call any SellAuth API action 1:1 (invoices, products, coupons, customers, tickets, subscriptions…).

When and how to use it

Connect the input from the preceding step on the path that should perform this operation.
Fill the fields with data available in the trigger's context.
Connect the needed outputs; an unconnected path cannot run later blocks.

Configuration fields

Action — operation


Choose the specific operation first, then fill only the inputs it requires. Different operations can return different data and can have different side effects.

Input: Fixed choice.

Default: invoices.get.

Available choices (preserve the exact value):
shop.stats — Shop: Get stats
invoices.list — Invoices: List
invoices.get — Invoices: Get
invoices.process — Invoices: Process
invoices.status — Invoices: Update status
invoices.archive — Invoices: Archive
invoices.unarchive — Invoices: Unarchive
invoices.note — Invoices: Update dashboard note
invoices.paid — Invoices: Update paid amount
invoices.ship — Invoices: Mark as shipped
invoices.deliver — Invoices: Deliver
invoices.replace — Invoices: Replace delivered
invoices.redo-dynamic — Invoices: Redo dynamic delivery
invoices.resend — Invoices: Resend email
invoices.reverse-affiliate — Invoices: Reverse affiliate commission
invoices.reverse-cashback — Invoices: Reverse cashback
products.list — Products: List
products.get — Products: Get
products.delete — Products: Delete
products.clone — Products: Clone
products.stock — Products: Update stock (variant)
products.deliverables — Products: Get deliverables (variant)
products.deliverables-append — Products: Append deliverables
products.deliverables-overwrite — Products: Overwrite deliverables
coupons.list — Coupons: List
coupons.get — Coupons: Get
coupons.create — Coupons: Create
coupons.update — Coupons: Update
coupons.delete — Coupons: Delete
coupons.delete-used — Coupons: Delete used
customers.list — Customers: List
customers.get — Customers: Get
customers.create — Customers: Create
customers.delete — Customers: Delete
customers.balance — Customers: Edit balance
customers.balance-history — Customers: Balance transactions
customers.newsletter — Customers: Set newsletter
customers.discord-revoke — Customers: Revoke Discord login
customers.tfa-disable — Customers: Disable 2FA
subscriptions.list — Subscriptions: List
subscriptions.get — Subscriptions: Get
subscriptions.cancel — Subscriptions: Cancel
checkout.create — Checkout: Create session
tickets.list — Tickets: List
tickets.stats — Tickets: Stats
tickets.get — Tickets: Get
tickets.create — Tickets: Create
tickets.close — Tickets: Close
tickets.reopen — Tickets: Reopen
tickets.message — Tickets: Send message
feedbacks.list — Feedback: List
feedbacks.stats — Feedback: Stats
feedbacks.get — Feedback: Get
feedbacks.reply — Feedback: Reply
feedbacks.dispute — Feedback: Dispute
abandoned.list — Abandoned checkouts: List
abandoned.stats — Abandoned checkouts: Stats
abandoned.recover — Abandoned checkouts: Send recovery
analytics.top-products — Analytics: Top products
analytics.top-customers — Analytics: Top customers
analytics.traffic — Analytics: Traffic stats
custom — Custom endpoint


ID — id


Primary resource ID for the selected API operation, such as an invoice or product. IDs from different resource types are not interchangeable.

Input: Text.

Editor guidance: Invoice, product, coupon, customer, ticket… ID. Supports {variables}.

Default: ``.


Variant ID — id2


Secondary resource ID required by some operations, such as a variant beneath a product. Read the selected endpoint's requirements.

Input: Text.

Editor guidance: Only for stock and deliverables actions.

Default: ``.


Parameters — params


Endpoint parameters using the format shown, usually key=value per line. Use the parameter names accepted by the selected API action.

Input: Multiline text.

Editor guidance: One key=value per line, e.g. status=completed. Lists: statuses=completed,refunded or JSON. Names match the SellAuth API docs.

Default: ``.


Method (custom only) — method


Choose the HTTP method required by the endpoint. GET reads; POST/PATCH/DELETE can change data. Verify against that API's current documentation.

Input: Text.

Editor guidance: GET, POST, PUT or DELETE

Default: GET.


Path (custom only) — path


Use the path format required by this block. Parse JSON selects a value inside JSON; custom API paths select an endpoint.

Input: Text.

Editor guidance: After /v1/shops/{shop}, e.g. /payment-methods

Default: ``.


Store as — storeAs


Choose a short result prefix such as result. Later blocks must use this same prefix and run after this block. It is not a Discord channel or a persistent table.

Input: Text.

Editor guidance: {sa.status}, {sa.json}, {sa.<field>}, lists: {sa.count}, {sa.list}, {sa.first.<field>}; errors: {sa.error}

Default: sa.

Outputs and next steps

ok: The operation succeeded.
failed: The operation failed; provide a safe error response.

Read the result after this block, using its configured prefix and the fields supported by the selected operation. Do not assume every response has a text or id field.

Test and troubleshoot

Install the corresponding plugin and configure its required accounts, channels and secrets. Test an API read before a write operation. An external-service error is not a reason to recreate the whole bot.

Save, validate and publish. Perform one real test and read the first relevant log error. [Testing](/docs/flow-testing) · [Variables](/docs/flow-variables) · [Permissions](/docs/flow-permissions).