// DEVELOPERS/Getting started/Quickstart

Quickstart

Send your first request, create a canvas, and read it back. About five minutes.

1. Install an SDK

Pick TypeScript, Python, or Go. The examples below use TypeScript.

// install.shShell
npm install @allo/sdk
# or
pip install allo
go get github.com/allo-io/allo-go

2. Create an API key

Go to Settings, Developers, API keys. Create a key with the scopes you need. For this guide, use canvas:write and project:read.

// WARN · Keep keys server side
Never embed an API key in a browser bundle. For browser flows, use OAuth 2.0 with PKCE.

3. Make your first request

// first-request.tsTypeScript
import { Allo } from "@allo/sdk"

const allo = new Allo({ apiKey: process.env.ALLO_KEY! })

const canvas = await allo.canvases.create({
  title: "My first canvas",
  blocks: [{ type: "text", body: "Hello, ALLO." }]
})

console.log(canvas.url)

4. Read it back

// read.tsTypeScript
const blocks = await allo.canvases.blocks(canvas.id)
console.log(blocks.length, "blocks")

Next steps