Wishpile

Adds a gift (or gift idea) for a person on the signed-in person's gift list. Give a product link to have Wishpile fill in the name, price and store; anything you pass explicitly wins. Status defaults to idea.

Adds a person the signed-in person is buying for to one of their current gift lists, optionally with a budget. If someone with that name is already on the list, nothing is added and their person_id is returned instead.

Adds an item to one of the signed-in person's own wishlists, personal or in a group. Give a product link to have Wishpile fill in the name, price, picture and store from the page; anything you pass explicitly wins over what the page says. Without a link, a name is required.

Claims an item on someone else's wishlist in the signed-in person's group, so others in the group know it's covered (the list's owner never sees it). Optionally also adds it as a gift idea for a person on the claimer's own gift list, like "Add to my gifts" in the app; get person ids from get_my_gift_lists.

Creates a new gift list for the signed-in person, for an occasion such as "Christmas 2027" or "Mom's birthday", optionally with its date for the countdown. Add people to it with add_person.

Creates a new, empty personal wishlist for the signed-in person, such as "Birthday", which they can share by link. Their list in a wishlist group already exists; use list_my_wishlists to find it.

Starts a wishlist group, such as "Harper Family Christmas", where family or friends each keep a wishlist and quietly claim items from each other's, with the signed-in person as its organizer. They join it with their own wishlist ("{First name}'s Wishlist"), and the reply includes the invite link for them to share; everyone who joins through it gets a wishlist too. Nothing is sent to anyone. Optionally ties the group to one of their gift lists (from get_my_gift_lists), so it shares that list's date, or sets the group's own date. Secret Santas are set up in the Wishpile app.

Deletes one of the signed-in person's gift lists (a shopping list for an occasion, such as "Christmas 2026"), along with the names and gift ideas tracked on it. This can't be undone. An empty list is deleted right away. If the list still has names or gifts on it, the first call changes nothing and says what's on it; call again with confirm true to go ahead. A gift that came from claiming a wishlist item frees up that item again. A wishlist group planned from the list is kept.

Deletes one of the signed-in person's personal wishlists and everything on it. This can't be undone, and its share link stops working. A list in a wishlist group can't be deleted here; it belongs to the group (remove its items instead).

Searches the gifts the signed-in person (and their household) is giving across their current gift lists, with filters, and returns matching gifts plus counts and totals. Statuses: idea (not bought yet), bought (bought but still needs wrapping), wrapped, done. Use it for questions like "how many gifts still need wrapping?" (status bought), "what have I bought under $50?", "what did I add this week?" "what's left to buy for the kids?" or "where's the Aveda oil?" (search). With a price filter, gifts that have no price come back in a separate without_price group. Gifts marked from_wishlist were claimed from someone's wishlist; they're the same gift as that claim, not an extra one.

Searches the wishlists of other people in the signed-in person's wishlist groups, with filters, and shows for each item whose list it's on, when it was added, and whether it's available, being got by them, or being got by someone else. Use it for questions like "what's new on Hailey's list?" (person plus added_since), "show me ideas under $50 nobody has claimed", "what have I claimed?" (claim_status claimed_by_me), "how much is already covered?" or "anything added this week?". Results include counts by claim status overall and per person. With a price filter, items that have no price come back in a separate without_price group. Never includes the signed-in person's own lists.

Gets the invite link for a wishlist group or Secret Santa the signed-in person organizes, for them to share themselves (by text, email, etc.). Nothing is sent. Anyone with the link can join, and new accounts that join through it count as the organizer's referral. Only the group's organizer can get it.

Shows the items on a wishlist in one of the signed-in person's groups and, for someone else's list, which items are still available, which they're getting, and which someone else is getting. On their own list no claim information is shown, and in a Secret Santa only their own claims are visible. Each item has the date it was added; pass added_since to see only what's new.

A status report for the signed-in person's current (not archived) gift lists, such as "Christmas 26", including lists shared by their household: for each list, gift counts and amounts by status, who's over budget, who has nothing bought yet, and how many gifts came from people's wishlists; and for each person, budget, planned total, remaining_budget, over_budget_by, counts and amounts by status, and wishlist_gift_count / own_idea_count. Every gift in the tracker has been picked out; status idea means not bought yet (still to buy), bought means bought but not wrapped, then wrapped, then done. Use it for "how am I doing on Christmas shopping?", "who am I over budget on?" or "how many gifts do I still need to buy?".

Shows the items on one of the signed-in person's own wishlists. Wishpile never tells a list's owner whether anything on it has been claimed, so no claim information is included.

A map of the signed-in person's whole Wishpile account in one call: their own wishlists (personal and in groups) with item counts, the wishlist groups and Secret Santas they belong to with who's in each, and their current gift lists with how many people and gifts each has, what's planned and bought, and who's over budget or has nothing bought yet. Names and counts only. Useful first for broad questions ("what do I have on Wishpile?", "how's Christmas shopping going?") and for finding the right list, group or person to look at next.

Shows the gifts the signed-in person (and their household) has planned or bought for one person on their gift list, with each gift's status (idea = not bought yet, bought = needs wrapping, wrapped, done), budget, remaining_budget or over_budget_by, and which gifts came from their wishlist (from_wishlist).

Everything about one person the signed-in person gives to, by name, in one answer: what's already in their gift tracker for them (with status, budget and spending), and their wishlist in any shared group with what's available, what the signed-in person is getting, and what others are getting. Use it for "what am I getting Hailey?", "what does Hailey still want?", "which things on Hailey's list am I buying?", "how much have I spent on Hailey?" or "am I done shopping for Hailey?". A gift can be in the tracker without ever being on a wishlist, so both parts matter. If the name matches more than one person, the answer says ambiguous: true and lists them; ask which one is meant (or call again with list) rather than guessing. One person per call: when they ask about several people, call it for each one, even someone you looked up earlier in the chat, so each person gets their own card and today's numbers.

Gets the link that lets family and friends see one of the signed-in person's personal wishlists and quietly claim items, without the owner ever seeing who's getting what. Lists in a group are shared with the group instead.

Lists the wishlist groups and Secret Santa groups the signed-in person belongs to, with the members' wishlists they can see.

Lists all of the signed-in person's own Wishpile wishlists with how many items each has: their personal wishlists and their own list in each wishlist group or Secret Santa they belong to.

Deletes a gift from the signed-in person's gift list. This can't be undone. If the gift came from claiming an item on someone's wishlist (from_wishlist), deleting it also releases that claim, so the item shows as available again, the same as in the app.

Removes a person from the signed-in person's gift list. This can't be undone. Removing someone also deletes every gift tracked for them, and any of those gifts that came from claiming a wishlist item releases that claim (the item shows as available again). If they have gifts, nothing is removed unless delete_gifts is true; the first call says how many gifts would go.

Deletes an item from one of the signed-in person's own wishlists, personal or in a group. This can't be undone.

Removes the signed-in person's claim on a group wishlist item so it's available again. If claiming it added a gift to their gift list, that gift is deleted too, as in the app.

Changes a gift on the signed-in person's gift list: its status (idea, bought, wrapped, done), price, name or notes. Only the fields given are changed. A new price stays in the gift's currency unless currency is given too.

Renames one of the signed-in person's current gift lists, or changes or clears its date. Only the fields given are changed. Archived lists are read-only.

Renames a person on the signed-in person's gift list or changes their budget (null clears it). Only the fields given are changed.

Changes the name, price, quantity, notes, link or must-have mark of an item on one of the signed-in person's own wishlists, personal or in a group. Only the fields given are changed. A new price stays in the item's currency unless currency is given too.