Developers
Build on Scratchboard with code or AI.
Every app you build in Scratchboard gets a REST API, event webhooks and an MCP endpoint automatically. Connect your own systems, scripts and AI assistants without extra setup.
Three ways in
Pick the one that fits: call the API, react to events, or let an AI assistant do the work.
REST API
Create, read, update and delete records in any entity you build, plus queries, bulk updates, imports and exports. Authenticate with an API key.
See the quick startEvent webhooks
Get an HTTPS POST when records change, approvals resolve or workflows run. Signed with HMAC-SHA256 and retried automatically.
Webhooks guideMCP server
Connect Claude, ChatGPT, Claude Code or any MCP client to your workspace through the hosted server. Sign in with OAuth, or use an API key.
MCP guideSDK
There is no published SDK package yet. The REST API and MCP server cover everything today.
SDK statusREST API quick start
Base URL https://api.scratchboard.cloud/v1. Send your API key as a Bearer token.
In Scratchboard, an entity is a type of record, like a table: Leads, Invoices, Employees. Each entity you create (yourself or with the AI Builder) is available at /v1/entity/<entity name>, using the entity's API name. The request body is a JSON object of field names and values.
curl -X POST https://api.scratchboard.cloud/v1/entity/leads \
-H "Authorization: Bearer ak_..." \
-H "Content-Type: application/json" \
-d '{"name": "Acme Corp", "email": "john@acme.com", "status": "new"}'curl "https://api.scratchboard.cloud/v1/entity/leads?pageSize=20&search=acme" \
-H "Authorization: Bearer ak_..."- GET
/entity/:entityNameList records (page, pageSize up to 100, search, filters)
- POST
/entity/:entityName/queryList with filters in a JSON body (for large filters)
- GET
/entity/:entityName/:idGet one record
- POST
/entity/:entityNameCreate a record
- PUT
/entity/:entityName/:idUpdate a record
- DELETE
/entity/:entityName/:idDelete a record (moves it to trash)
- POST
/entity/:entityName/bulk-updateUpdate many records at once
Paths are relative to https://api.scratchboard.cloud/v1.
Keys, permissions and limits
What to know before you write your first integration.
API keys
Create keys on the API Keys page in the app's admin area. Keys start with ak_, are shown once, can expire, and can be limited to specific permissions.
Same permissions as the app
A key acts as the user who created it. Role, record scope and field-level permissions (RBAC) apply to every request, and changes are written to the audit log.
Rate limits
Requests per minute depend on your plan: 120 on Starter, 600 on Pro, custom on Enterprise.
Works with
AI clients over MCP, plus data sources you can sync from inside the app.
Questions
Straight answers for developers.
Which plans include API access?
Do I need to define an API for each app I build?
Can an API key see everything in the workspace?
Is there an SDK?
Where to next
Keep exploring, or start building.
Get your API key
Start a 7-day free trial, create an entity, then generate a key from the API Keys page.