Skip to main content
Moonshadow is built around a small set of concepts that work together to connect your tools, automate your processes, and keep your team informed. Understanding these building blocks will help you design workflows that fit your team and integrate Moonshadow confidently via the API. Every resource in Moonshadow lives inside a workspace, is accessed by members with specific roles, and interacts with external tools through integrations that emit events you can act on.

Workspaces

Team-level containers that hold integrations, members, API keys, and automation rules. Everything you do in Moonshadow happens inside a workspace.

Integrations

Connections to external tools like Slack, GitHub, and Jira. Integrations listen for activity and trigger events inside Moonshadow.

Events

Real-time notifications emitted by integrations. Use webhooks to forward events to your own systems, or consume them through Moonshadow automations.

Permissions

Role-based access control with Owner, Admin, Member, and Viewer roles. Permissions determine who can manage integrations, invite users, or view billing.

​
Workspace

A workspace is the top-level organizational unit in Moonshadow. It groups integrations, members, API keys, and automation rules in one place. Most teams start with a single workspace, but you can create as many as you need for different teams or environments.

​
Integration

An integration is a connection between Moonshadow and an external tool. When you connect an integration, Moonshadow listens for events from that tool, such as new pull requests in GitHub or alerts in PagerDuty. You can then route those events into notifications, automations, or your own systems via webhooks.

​
Event

Events are the signals that drive Moonshadow workflows. Each time something notable happens in a connected tool, Moonshadow receives an event. You can inspect events in the dashboard, subscribe to them via webhooks, or use them to trigger automation rules.

​
Permission

Permissions control what each member can do inside a workspace. Moonshadow uses a role-based model: Owner, Admin, Member, and Viewer. Owners and Admins can manage integrations and billing, while Viewers have read-only access. Assigning the right roles keeps your workspace secure and predictable.