miro-webhooks-events

# Miro Webhooks & Events ## Overview Receive real-time notifications when items on a Miro board change. Miro uses **board subscriptions** via the `/v2-experimental/webhooks/board_subscriptions` endpoint. All board item types are supported except tags, connectors, and comments. ## Prerequisites - Access token with `boards:read` scope - HTTPS endpoint accessible from the internet - Webhook signing secret (generated when creating subscription) ## Create a Board Subscription ```typescript // POST https://api.miro.com/v2-experimental/webhooks/board_subscriptions async function createBoardSubscription(boardId: string, callbackUrl: string) { const response = await fetch( 'https://api.miro.com/v2-experimental/webhooks/board_subscriptions', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.MIRO_ACCESS_TOKEN}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ boardId, callbackUrl, // Must be HTTPS status: 'enabled', // 'enabled' | 'disabled' }), } ); const subscription = await response.json(); console.log(`Subscription created: ${subscription.id}`); console.log(`Type: ${subscription.type}`); // 'board_subscription' return subscription; } ``` ## Manage Subscriptions ```typescript // List subscriptions // GET https://api.miro.com/v2-experimental/webhooks/board_subscriptions const list = await miroFetch('/v2-experimental/webhooks/board_subscriptions'...