Create a group decision
create_decisionCreate a poll, check-in, availability board, or ranking and get a link to share with the group.
Easiest: pass text in plain language and SettleIt infers the type and options, e.g. "Dinner: pizza or thai" (poll), "Who's in for bowling Thursday?" (checkin), "Find a time for dinner next week" (availability), "Rank snacks: chips, popcorn, pretzels" (ranking).
For exact control, pass question plus options (2-5 for polls, 2-12 for rankings); with question alone you get a check-in. Availability must be created from text.
For availability, also pass the user's timezone (IANA name, e.g. "America/Los_Angeles") so the time slots are in their local time; without it slots are in UTC.
Returns the decision (share its url), plus an admin_token and manage_url to keep private.
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_decision"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | Plain-language prompt. Max 200 characters except rankings. | |
| type | No | Force a type. Optional with text. | |
| options | No | Unique choices, used with question. | |
| question | No | ||
| timezone | No | Availability: the user's IANA time zone, e.g. "America/Los_Angeles". Slots and words like "tomorrow" use it. Defaults to UTC. | |
| closes_in_minutes | No | Polls only: auto-close after this many minutes. |