Create a new giveaway
create_giveawayCreate a new giveaway tied to a shop offer by setting the required offer ID and quantity, with optional message or username. Requires explicit user confirmation.
Instructions
Rate limit: 100 requests / 10 seconds per shop. See Rate limiting.
Creates a new giveaway
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_giveaway"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | Exact private shop profile label; not a provider identity or authorization proof. | |
| confirm | No | Set true only when the user asked for exactly this action. | |
| message | No | ||
| offerId | No | ||
| payload | No | Complete current native JSON body; cannot mix with native body flags or payload_file. | |
| quantity | No | ||
| username | No | ||
| payload_file | No | Absolute regular non-symlink native JSON body file, at most1MiB. Cannot mix with payload or body flags. |