> For the complete documentation index, see [llms.txt](https://developers.spiffy.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.spiffy.co/connectors/spiffy/examples.md).

# Example prompts

These show the connector in action. Each one lists the tools the assistant is likely to call and what you should get back. They also make a quick connection test.

Anything that writes or deletes data should prompt you to confirm first. Read-only prompts just run.

### Look up recent orders

> *Show me my 10 most recent orders and flag any that were refunded.*

Calls `list_orders`. You get the latest 10 orders with customer, amount, and status, refunded ones called out, each linking back to the order in your dashboard.

### Investigate a customer

> *Find the customer with email <jane@example.com> and summarize their orders and active subscriptions.*

Calls `list_customers` and `get_customer`, then `list_orders` and `list_subscriptions`. You get the customer, a summary of their order history, and any active subscriptions with renewal dates.

### Refund an order (asks first)

> *Refund order 10432 in full, the customer was double charged.*

Reads the order with `get_order`, then asks you to confirm before calling `refund_order`. Once you approve, it issues the refund and reports the amount and new status.

### A date-based question

> *How many subscriptions renewed last week?*

Calls `get_utc_time` first to pin down what "last week" means, then `list_subscriptions`. The conversion matters because Spiffy stores timestamps in UTC, so "last week" has to be worked out in UTC for the filter to line up.

### Create a promotion (asks first)

> *Create a 20% off promotion with the code SPRING20 that expires at the end of next month.*

Works out the expiry with `convert_to_utc`, confirms the details, then calls `create_promo` and returns the new code's ID and settings.

### Rotate a webhook secret (asks first)

> *Rotate the signing secret on my production webhook endpoint.*

Finds the endpoint with `list_webhookendpoints`, confirms, then calls `rotate_webhook_endpoint_secret` and hands back the new secret so you can update your receiver.

### Ask a product question

> *How does Spiffy handle failed subscription payments and dunning?*

Calls `search_help_docs`, and `get_help_article` if it needs the full text. You get an answer from Spiffy University with links to the articles.

### Across multiple accounts

If your connection covers more than one account, name the account so a write lands in the right place:

> *In the Acme Co account, list subscriptions that are past due.*

Calls `list_subscriptions` against Acme Co. For a write across multiple accounts, the assistant asks which account to use when it isn't obvious.
