AI agents: Logbook can be used programmatically. Start at https://logbook.zone/llms.txt. Remote MCP server: https://logbook.zone/mcp. Read-only REST API: https://logbook.zone/api/v1. Local MCP server: npx -y @logbookprotocol/mcp.

Logbook Beta on Sui Testnet. Learn more →
Documentation

Learn Logbook

Everything you need to create blockchain-verified surveys, understand the technology, and get the most out of Logbook.

DocsQuick Start
4 min read

Quick Start Guide

Create your first campaign in just a few minutes.

#Step 1: Sign In

Click the "Log in" button on the homepage. You have two options:

  • Google Account: Click "Continue with Google" to sign in with your existing Google account. No wallet needed!
  • Crypto Wallet: Click any supported wallet (Slush, Phantom, etc.) to connect

#Step 2: Create a Campaign

Click "New Campaign" in the navigation. You have two ways to create your campaign:

Click "AI" at the top of the New Campaign page and describe your campaign in natural language. For example: > "Create a poll about where to have our team dinner, deadline end of month"

The AI will generate title, description, questions, and settings automatically. Just review and apply the suggestions!

#Option B: Manual Creation

Fill in your campaign details manually:

  • Participants: Anyone, people with the campaign password, a list of Sui addresses, or the members of a group you run
  • Answers visible to: Everyone, everyone with access, voters only, only you, or nobody until the end date and everyone with access from then on
  • Title: Give your campaign a clear, descriptive name
  • Description: Explain what you're asking about and why
  • End Date: Set when the campaign should stop accepting responses

#Step 3: Add Questions

If using AI Assistant, questions are generated automatically. For manual creation, click "Add question" to create your survey questions. Choose from three types:

  • Single Choice: Respondents pick exactly one option
  • Multiple Choice: Respondents can select multiple options
  • Text Answer: Respondents type a free-form response
For each question, you can mark it as required or optional and add as many answer options as needed.

#Step 4: Review and Deploy

  1. 1Click "Preview & Publish" to see a preview
  2. 2Check that everything looks correct
  3. 3Click "Publish Campaign" (wallet users then confirm the transaction in their wallet)

#Step 5: Edit or Delete (Optional)

Before anyone responds, you can still make changes:

  • Edit: Update title, description, questions, or end date (until the campaign ends)
  • Delete: Remove the campaign entirely (also after it ended)
Once your campaign receives its first response, it becomes immutable — this ensures participants can trust that questions haven't changed after they responded. Once it has ended it cannot be edited or reopened either, even without responses. A campaign for the members of a group cannot be edited at all: delete it before the first response and create it again (see Campaigns for Groups).

Anyone can respond to a campaign open to everyone within seconds of publishing, and a single response locks it. If you may still want to edit after publishing, choose "people with the campaign password" as participants: nobody without the link can respond, so the campaign stays editable until you share it.

#Step 6: Share Your Campaign

Once deployed, you can share your campaign via:

  • Direct link: Copy and send the URL
  • QR code: Display in the campaign details page
For a password campaign, open "Share" on the campaign page: it shows the password and lets you include it in the link and QR code. Anyone who gets that link can open the campaign and respond; nobody else can, because the smart contract checks the password. The password is derived from the campaign's key, so as the creator you can always get it back by opening the campaign.

#Step 7: Monitor Results

Visit your campaign page to see:

  • Real-time response counts
  • Aggregated results with charts
  • The list of respondents with links to their transactions
When the campaign ends, results are finalized and permanently recorded on the blockchain.