Extensions & Marketplace

Extensions add new capabilities to Spun — install from the Marketplace or build your own with the Extension SDK.

What are Extensions?

Extensions are mini-apps that run inside Spun, adding features like:

• Custom contact detail panels
• Third-party integrations (Stripe, Shopify, etc.)
• Specialized automation tools
• Industry-specific workflows

Installing extensions

1. Navigate: Sidebar → Extensions (Puzzle icon)
2. Browse the Marketplace — categorized catalog
3. Click "Install" on any extension
4. Grant permissions — review what data the extension can access
5. Configure — some extensions need API keys or settings

Extension types

Type	What it does	Example
Panel	Adds a sidebar panel or contact detail section	CRM viewer, order lookup
Action	Adds actions to the message/chat context menu	"Create invoice", "Add to CRM"
Automation	Adds triggers/actions to Chat Flows	"When payment received → label as Paid"
Widget	Embeds a UI in the chat composer	Product selector, appointment picker

Popular extensions

• Contact Notes — Rich notes with formatting on each contact
• Classes & Workshops — Session scheduling and enrollment tracking
• Creator Hub — Content creation tools for social/marketing teams

Building your own

Extension SDK

Spun provides an SDK for building custom extensions:

1. Scaffold: npx create-spun-extension my-extension
2. Develop: Write your extension using the SDK APIs
3. Test: Local dev server with hot reload
4. Publish: Submit to the Marketplace (or keep private to your org)

SDK APIs available

• spun.contacts — read/write contacts
• spun.messages — read messages, send messages
• spun.labels — read/apply labels
• spun.ui — render panels, modals, notifications
• spun.storage — key-value storage per org
• spun.webhooks — register webhook handlers

Developer Portal

Settings → Developer Portal gives you:

• API key management
• Extension submission
• Usage analytics
• Webhook configuration

Permissions model

Extensions request specific permissions:

• contacts:read — view contacts
• contacts:write — edit contacts
• messages:read — read messages
• messages:send — send messages
• labels:manage — create/apply labels
• storage:write — save data

You approve these on install. Extensions cannot exceed their granted permissions.

Related

• Developer Portal — API keys and submission
• Webhooks — event-driven integrations
• Chat Flows — automation that extensions can enhance