Integrations
Connecting partner services to AeThex
AeThex Integrations wrap third-party analytics, identity, payments, and live-ops tooling behind a consistent runtime, security model, and visual system. Use this guide to register new connectors, surface partner UI in product flows, and automate data exchange without hand-rolled plumbing.
Architecture Overview
Runtime Flow
Integration manifests are stored in the AeThex Integrations service and synced across the dashboard and runtime. Client components resolve connector metadata through the shared API helpers, ensuring credentials and capability flags stay consistent with server state.
During hydration the runtime mounts partner SDKs behind AeThex loaders, applying sandboxed execution where required. Use lifecycle hooks to emit analytics, hydrate widgets with scoped credentials, and gate access through the same role-based policies used elsewhere in the platform.
Theming Hook
Use the integration theming utilities to adapt partner widgets to AeThex gradients, typography, and focus states. Tokens flow through CSS variables defined in global.css, so embeds stay visually aligned with dashboards and consumer apps.
Connector Configuration
Required Fields
key
Unique identifier referenced across dashboards, APIs, and audit logs
"analytics-segment"
category
Integration taxonomy (analytics, identity, commerce, ops)
"analytics"
capabilities
Feature flags that unlock widgets, hooks, and pipelines
['metrics', 'webhooks']
connectionMode
Credential management (oauth, apiKey, managedVault)
"oauth"
webhookEndpoint
Optional callback URL for outbound events
"https://app.example.com/aethex/webhooks"
uiEmbeds
Declarative config for dashboard cards and modals
[{ surface: 'dashboard', placement: 'sidebar' }]
Common Integrations
Analytics
Connect your analytics platform to track KPIs and user behavior.
Supported platforms:
Segment
Mixpanel
Amplitude
Custom webhooks
Identity & Auth
Integrate third-party identity providers for single sign-on.
Supported platforms:
Auth0
Okta
Azure AD
Custom OAuth
Payments & Commerce
Sync purchase events and manage subscriptions.
Supported platforms:
Stripe
Paddle
Gumroad
Custom webhooks
Live Operations
Connect incident management and status page services.
Supported platforms:
PagerDuty
OpsGenie
Datadog
Custom webhooks
Troubleshooting
OAuth Handshake Fails
Confirm the integration's redirect URI matches the value registered in the partner console. AeThex surfaces expose the required callback under Settings → Integrations.
Webhook Retries Exhausted
Inspect delivery attempts in the Integrations dashboard. Update retry policies or verify your endpoint responds with a 2xx status within 10 seconds.
Embedded Widget Styling
Override component tokens through the integration theme utilities or wrap the widget in a container that inherits AeThex gradient variables.
Building Custom Integrations
Step 1: Register Connector
Create a manifest in your integration service:
Step 2: Implement OAuth Flow
Handle the OAuth handshake to securely store credentials.
Step 3: Create UI Components
Build dashboard cards or modal embeds using the AeThex component library.
Step 4: Setup Webhooks
Configure event forwarding for real-time data sync.
Best Practices
Always validate webhook signatures
Use managed vaults for sensitive credentials
Implement rate limiting for API calls
Test integrations in preview environments first
Monitor webhook delivery and retry failures
Document your integration with examples
Support
For integration support and questions:
Last updated