Developer Overview
Connect AI assistants, build integrations, and automate workflows with the Shocking Energy developer platform.
Shocking Energy provides a developer platform for connecting AI assistants and building integrations with your team data. The platform offers three access methods depending on your use case.
Access methods
AI Assistant
The in-dashboard chat. Ask questions about jobs, flows, and team data; get rich charts, tables, and one-click remediation. No setup — just open the chat sheet.
Chat Bot
Slack, Telegram, and WhatsApp commands for jobs, notes, flows, and team queries. Falls back to the AI assistant for natural-language questions.
MCP Integration
Connect external AI assistants like Claude, Cursor, and other MCP-compatible tools to query and manage your team data through tools, resources, and prompts.
REST API
A versioned HTTP API for building custom integrations, dashboards, and automation workflows.
OAuth Applications
Register OAuth 2.1 applications to let third-party services access your team data with user-approved permissions.
Authentication
All API access requires authentication. Two methods are supported:
API keys
API keys are the simplest way to authenticate. Create them from Settings > Developer > API Keys.
- Keys use the
se_*prefix - Pass via the
Authorization: Bearer se_...header - Each key is scoped to a team
- Keys can be assigned specific permission scopes or default to full access
OAuth tokens
OAuth 2.1 tokens are issued through the authorization code flow. They are ideal for third-party integrations where a user approves access.
- Claude.ai uses OAuth automatically (no API key needed)
- Tokens include a refresh token for long-lived access
- Scopes are approved by the user during the consent flow
See Permissions and Scopes for a full reference of available scopes and how they control access.
Getting started
Enable MCP (optional)
Go to Settings > MCP and toggle MCP on. This is required for AI assistant connections but not for REST API usage.
Create an API key
Go to Settings > Developer > API Keys and create a new key. Choose the scopes your integration needs. Copy the key immediately — it is only shown once.
Connect or integrate
Follow the MCP setup guide to connect an AI assistant, or use the REST API to build a custom integration.