# Meshes

> Meshes is the outbound integration layer for SaaS products. It replaces hand-rolled integration code with a single API that routes product events (signups, payments, user actions) to tools like HubSpot, Salesforce, Intercom, Mailchimp, Slack, webhooks, and more — with automatic retries, fan-out, replay, and multi-tenant workspace isolation.

Canonical: https://meshes.io/llms.txt
Full reference: https://meshes.io/llms-full.txt
Last updated: 2026-05-05

Meshes is designed for solo developers and engineering teams at SaaS companies of any size who currently maintain custom integration code. Instead of building and maintaining webhook delivery, retry logic, OAuth token management, and field mappings for each destination, teams emit events once and Meshes handles routing and delivery.

## Core Concepts

- **Workspace**: Tenant-scoped container for connections, rules, event logs, and a publishable key. In multi-tenant apps, create one workspace per customer.
- **Connection**: Configured destination (OAuth, API key, or webhook URL) inside a workspace with per-tenant credentials and action configuration.
- **Rule**: Binds an event type to a connection action (e.g., `add_to_list`, `create_or_update_contact`, `send_webhook`). Can filter by `event`, `resource`, and `resource_id`.
- **Event**: JSON payload emitted by your application and delivered to all matching rules within a workspace. Tracks delivery status across all matched rules.

## API Basics

- Base URL: `https://api.meshes.io/api/v1`
- Browser-friendly event ingestion: `https://events.meshes.io/api/v1` (CORS-enabled, for `/events` and `/events/bulk`)
- Management auth: `Authorization: Bearer <machine-jwt>` (short-lived HS256 JWT, max 60s)
- Event ingestion auth: `X-Meshes-Publishable-Key: <workspace_publishable_key>` (or Bearer JWT)
- Event body shape: `event` + `payload` (optional `resource`, `resource_id`, `workspace`)

## Embedded Workspace

- Meshes supports embedded workspace pages for `dashboard`, `connections`, `rules`, `events`, `event detail`, and `connection mappings`.
- Host backends mint workspace-scoped sessions with `POST /api/v1/sessions` using management credentials.
- Session minting returns both an `access_token` and a `launch_url`.
- `launch_url` is only for the initial iframe bootstrap request. The runtime session token is sent later with `postMessage` after the iframe sends `meshes:ready`.
- Hosts should validate `event.origin` against the embed origin from `launch_url` before handling iframe messages.
- Hosts should handle `meshes:token-refresh`, `meshes:token-expired`, `meshes:navigate`, and `meshes:resize`.
- Sensitive reads such as event payload access require explicit session scope, currently `events.payload:read`.
- `members` and `settings` remain web-only and are not part of the current embed surface.

## Supported Integrations

ActiveCampaign, AWeber, Customer.io, Discord, HubSpot, Intercom, Mailchimp, MailerLite, Pipedrive, Resend, Salesforce, SendGrid, Slack, Webhooks, Zoom

## Primary Docs

- [Documentation Home](https://meshes.io/docs)
- [Getting Started](https://meshes.io/docs/getting-started/getting-started)
- [Core Concepts](https://meshes.io/docs/getting-started/core-concepts)
- [Quickstart](https://meshes.io/docs/getting-started/quickstart)
- [API Overview](https://meshes.io/docs/getting-started/api-overview)
- [API Reference (OpenAPI)](https://docs.meshes.dev)
- [Authentication](https://meshes.io/docs/api/authentication)
- [SDKs](https://meshes.io/docs/api/sdks)
- [Integrations & Rules](https://meshes.io/docs/api/integrations-and-rules)
- [Integrations Docs Hub](https://meshes.io/docs/integrations/integrations)
- [ActiveCampaign Integration Docs](https://meshes.io/docs/integrations/activecampaign)
- [AWeber Integration Docs](https://meshes.io/docs/integrations/aweber)
- [Customer.io Integration Docs](https://meshes.io/docs/integrations/customer_io)
- [Discord Integration Docs](https://meshes.io/docs/integrations/discord)
- [HubSpot Integration Docs](https://meshes.io/docs/integrations/hubspot)
- [Intercom Integration Docs](https://meshes.io/docs/integrations/intercom)
- [Mailchimp Integration Docs](https://meshes.io/docs/integrations/mailchimp)
- [MailerLite Integration Docs](https://meshes.io/docs/integrations/mailerlite)
- [Pipedrive Integration Docs](https://meshes.io/docs/integrations/pipedrive)
- [Resend Integration Docs](https://meshes.io/docs/integrations/resend)
- [Salesforce Integration Docs](https://meshes.io/docs/integrations/salesforce)
- [SendGrid Integration Docs](https://meshes.io/docs/integrations/sendgrid)
- [Slack Integration Docs](https://meshes.io/docs/integrations/slack)
- [Webhooks Integration Docs](https://meshes.io/docs/integrations/webhooks)
- [Zoom Integration Docs](https://meshes.io/docs/integrations/zoom)
- [Send Events](https://meshes.io/docs/events/send-events)
- [Bulk Events](https://meshes.io/docs/events/bulk-events)
- [Embed & Sessions](https://meshes.io/docs/embed/embed)
- [Embed Quickstart](https://meshes.io/docs/embed/quickstart)
- [Session API Overview](https://meshes.io/docs/embed/session-api)
- [Launch URL and Iframe Bootstrap](https://meshes.io/docs/embed/launch-bootstrap)
- [Iframe Message Contract](https://meshes.io/docs/embed/postmessage-contract)
- [Session Roles and Scopes](https://meshes.io/docs/embed/roles-and-scopes)
- [Workspace Pages Available in Embed](https://meshes.io/docs/embed/workspace-pages)
- [Session Refresh Lifecycle](https://meshes.io/docs/embed/session-refresh)
- [OAuth and Connection Setup Behavior](https://meshes.io/docs/embed/oauth-connections)
- [Iframe Sizing and Resize Handling](https://meshes.io/docs/embed/iframe-sizing)
- [Security Model](https://meshes.io/docs/embed/security)
- [Troubleshooting](https://meshes.io/docs/embed/troubleshooting)
- [AI Tools](https://meshes.io/docs/ai/ai)
- [AI Docs Index](https://meshes.io/docs/ai/llms)

## SDKs

- [Node.js / TypeScript Management SDK](https://www.npmjs.com/package/@mesheshq/api): `@mesheshq/api`
- [Node.js / TypeScript Events SDK](https://www.npmjs.com/package/@mesheshq/events): `@mesheshq/events`
- [Go SDK](https://github.com/mesheshq/go-meshes): `github.com/mesheshq/go-meshes`

## Pricing

- **Dev** (Free): 100 events/month
- **Builder** ($49/mo): 2,500 events/month
- **Pro** ($199/mo): 25,000 events/month
- **Scale** ($499/mo): 100,000 events/month
- **Enterprise** (Custom): Custom event limits, dedicated support, SLAs
- [Pricing Page](https://meshes.io/pricing)

## Optional

- [Status Page](https://meshes.statuspage.io/): Uptime and incident status
- [Blog](https://meshes.io/blog): Technical articles on webhook patterns, integration architecture, and SaaS event routing
- [Use Cases](https://meshes.io/use-cases): Practical lifecycle, onboarding, and behavioral event-routing examples for payment failures, signups, course progress, tutorial triggers, and purchase intent workflows
- [Guides](https://meshes.io/guides): Detailed workflow guides for lifecycle and behavioral event routing, from single-destination Slack and HubSpot flows to onboarding and high-intent behavior handoffs
- [Integrations Catalog](https://meshes.io/integrations): Public directory of supported destinations, authentication models, actions, and Meshes-specific integration workflows
- [Use Case: Payment Failed Notifications](https://meshes.io/use-cases/payment-failed-notifications): Route payment.failed events to Slack, Intercom, Salesforce, and Resend with delivery guarantees
- [Use Case: User Signup Fan-Out](https://meshes.io/use-cases/user-signup-fan-out): Fan one signup event out to HubSpot, Mailchimp, Intercom, and Slack
- [Use Case: Churn Prevention](https://meshes.io/use-cases/churn-prevention-event-routing): Route subscription.cancelled signals to CS, RevOps, and lifecycle tools
- [Use Case: Trial Expiry Notifications](https://meshes.io/use-cases/trial-expiry-notifications): Route trial.ending events into email, CRM, and lifecycle workflows
- [Use Case: Lesson Completion Flows](https://meshes.io/use-cases/lesson-completion-flows): Route lesson.completed events into CRM, lifecycle email, instructor alerts, and milestone automation
- [Use Case: Page Completion Triggers](https://meshes.io/use-cases/page-completion-onboarding-sequences): Route page.completed events into onboarding email, in-app messaging, and team alerts
- [Use Case: Page Visit Intercom Tutorial Flows](https://meshes.io/use-cases/page-visit-intercom-tutorial-flows): Route high-intent page.visited signals into Intercom tutorials, Slack alerts, and internal webhooks
- [Use Case: Page Visit SMS Purchase Targeting](https://meshes.io/use-cases/page-visit-sms-purchase-targeting): Route repeated sales-page visits into CRM enrichment, SMS-ready automation, and sales alerts
- [Guide: Send Payment Failure Alerts to Slack](https://meshes.io/guides/send-payment-failures-to-slack): Route payment.failed into Slack with retries, replay, and delivery visibility
- [Guide: Update HubSpot on User Signup](https://meshes.io/guides/add-hubspot-properties-on-signup): Push user.signup into HubSpot property updates and list membership
- [Guide: Send Signup Events to Mailchimp Welcome Flows](https://meshes.io/guides/send-signup-events-to-mailchimp): Start Mailchimp welcome automation from user.signup
- [Guide: Update Salesforce When Users Change Plans](https://meshes.io/guides/update-salesforce-on-plan-change): Route plan-change signals into Salesforce CRM updates
- [Guide: Tag Intercom Users When Trials Are About to Expire](https://meshes.io/guides/tag-intercom-users-on-trial-expiry): Push trial.ending into Intercom tags for lifecycle messaging
- [Guide: Update HubSpot on Lesson Completion](https://meshes.io/guides/lesson-completed-hubspot-progress): Turn lesson.completed into HubSpot progress and CRM state updates
- [Guide: Send Lesson Completion Events to Mailchimp Sequences](https://meshes.io/guides/lesson-completed-mailchimp-sequence): Start Mailchimp lifecycle email from lesson.completed
- [Guide: Tag Intercom Users from High-Intent Page Visits](https://meshes.io/guides/page-visit-intercom-high-intent): Route repeated page.visited signals into Intercom tags and tutorial handoffs
- [Guide: Trigger ActiveCampaign Onboarding Sequences from Page Completion](https://meshes.io/guides/page-completion-activecampaign-sequence): Send page.completed into ActiveCampaign onboarding automation
- [Guide: Route High-Intent Page Visits into HubSpot SMS Workflows](https://meshes.io/guides/page-visit-hubspot-sms-intent): Push page.visited purchase-intent signals into HubSpot follow-up workflows
- [Compare Pages](https://meshes.io/compare): Overview of Meshes vs. DIY, Zapier, Make, n8n, Paragon, and Merge
- [Compare: Meshes vs. DIY](https://meshes.io/compare/diy): Side-by-side comparison of building integrations yourself vs. using Meshes
- [Compare: Meshes vs. Zapier](https://meshes.io/compare/zapier): Side-by-side comparison of workflow automation vs. Meshes for product event delivery
- [Compare: Meshes vs. Make](https://meshes.io/compare/make): Side-by-side comparison of visual automation scenarios vs. Meshes as a delivery layer
- [Compare: Meshes vs. n8n](https://meshes.io/compare/n8n): Side-by-side comparison of workflow orchestration vs. Meshes for reliable event delivery
- [Compare: Meshes vs. Paragon](https://meshes.io/compare/paragon): Side-by-side comparison of Paragon's all-in-one embedded integration platform vs. Meshes' focused delivery layer
- [Compare: Meshes vs. Merge](https://meshes.io/compare/merge): Side-by-side comparison of inbound unified APIs vs. outbound event delivery
- [Cursor Rules Repository](https://github.com/mesheshq/meshes-ai-tools): Cursor rules for AI-native development
- [MCP Server Repository](https://github.com/mesheshq/meshes-mcp-server): Standalone MCP server for AI agents