Start a Chorus book, and get the one link to forward.
start_bookStarts a book of voice, video and written messages and returns its handle and the single link the organiser sends to everyone taking part. The book is for one person or a couple, or it goes by a title when it is for nobody in particular: a family’s recipes, a class’s year, a team’s goodbye. Gathering is free, and the people recording need no app and no account. It needs organiser_email, the address Chorus lets the organiser know about responses at, unless they are signed in through the connector. The book is made at once and the link comes back. Chorus emails the link to that address and emails it each time somebody responds, and the book moves into their account when they sign in with it or open keep_link.
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": "start_book"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | Optional. The six digit code emailed to the organiser, which puts the book straight into their account. Without it the book is made at once. | |
| steps | No | What each person is given, in order, one screen each, when the book needs more than questions. Each step is { kind, text }: words (a question answered by voice, video or writing, text required), song (they search for it or paste a Spotify, YouTube or Apple Music link; it prints as the page's heading with a code that plays it), photo, voice (a voice note that prints as a code on their page), date, choice (with choices, two to eight), link (prints as a code), name (who it is from; first when left out). text is the screen's question, with {name} for the person; without it, a song, photo, voice or name screen carries Chorus's own wording. optional: false makes a photo, voice, date, choice or link one they cannot skip. Each person's answers make one page. Steps outrank questions. Example for a song book: [{kind:'song'},{kind:'words',text:'Why does it remind you of {name}?'},{kind:'photo'},{kind:'voice'},{kind:'name'}]. | |
| title | No | The book’s title, in the person’s words, for example The Kelly family recipes. One line, up to 40 characters. | |
| occasion | No | A big birthday, A wedding, A new baby, As they grow, In memory, or Something else. Plain words are matched to one of those. | |
| closes_on | No | Optional. The day collecting stops, as 2026-11-14. Without it the book stays open until it is closed, and a date can be set at any time after. A printed copy wanted for a day needs collecting to stop three weeks before it. | |
| expecting | No | Who is expected to record, by name or role, without email addresses. The book’s status names the ones still out. | |
| lead_with | No | Which of those is the big button on a contributor’s phone. | |
| questions | No | The questions everybody answers, up to 12, each one line of up to 200 characters that a person can answer out loud in a minute or two. In a book with subject_name, {name} in a question becomes that name. When this is left out, a book with subject_name gets the set for the occasion and a book with only a title gets three open questions. | |
| answer_with | No | Any of voice, video and written. Voice and written when not said. | |
| subject_name | No | Who the book is for, when it is for one person or a couple, as the organiser says it, for example Mum. A book needs subject_name, title or both, and a book for one person needs only subject_name. | |
| organiser_email | No | Where Chorus lets the organiser know about responses. Needed unless they are signed in through the connector. The link is emailed there too. |