Integrations

NovaKit integrates with popular platforms to send notifications, trigger automations, and connect your AI workflows to thousands of apps.

Available Integrations

Slack Integration

Connect Slack to receive real-time notifications when events occur in NovaKit.

Setup

1. Go to Dashboard → Settings → Integrations → Connectors
2. Click Connect Slack
3. Authorize NovaKit to access your Slack workspace
4. Select a default channel for notifications
5. Choose which events to notify on

Features

• Real-time Notifications: Get instant updates on generations, agent runs, and more
• Channel Selection: Choose which channel receives notifications
• Rich Formatting: Messages include formatted content, links, and metadata
• Event Filtering: Only receive notifications for events you care about

Notification Events

Select which events trigger Slack notifications:

• Generation completed/failed
• Agent run completed/failed
• Credits low/depleted
• Team member changes
• Subscription updates

Example Notification

🎨 Image Generated Successfully

Model: fal-ai/flux/dev
Prompt: "A sunset over mountains"
Duration: 3.2s
Credits: 5

[View Image] [Open Dashboard]

Discord Integration

Send notifications to Discord channels using webhooks.

Setup

1. In Discord, go to Server Settings → Integrations → Webhooks
2. Click New Webhook
3. Copy the webhook URL
4. In NovaKit, go to Settings → Integrations → Connectors
5. Click Connect Discord
6. Paste your webhook URL
7. Configure the bot name and avatar (optional)

Configuration Options

{
  "webhookUrl": "https://discord.com/api/webhooks/...",
  "username": "NovaKit Bot",
  "avatarUrl": "https://www.novakit.ai/logo.png",
  "notifyOnEvents": [
    "generation.completed",
    "credits.low"
  ]
}

Features

• Rich Embeds: Notifications include images, colors, and formatted content
• Custom Bot Name: Set a custom name for the webhook messages
• Custom Avatar: Use your own avatar image
• Event Filtering: Choose which events to notify on

Zapier Integration

Connect to 5,000+ apps through Zapier automations.

Setup

1. In Zapier, create a new Zap
2. Choose Webhooks by Zapier as the trigger
3. Select Catch Hook
4. Copy the webhook URL
5. In NovaKit, go to Settings → Integrations → Connectors
6. Click Connect Zapier
7. Paste your webhook URL
8. Select which events trigger the Zap

Use Cases

• Google Sheets: Log all generations to a spreadsheet
• Notion: Create pages for completed agent runs
• Email: Send email notifications for important events
• Trello: Create cards when tasks are generated
• Airtable: Build a database of AI-generated content

Example Zap: Log Images to Google Sheets

Trigger: NovaKit → generation.completed (image) Action: Google Sheets → Create Row

Make Integration

Build powerful automations with Make (formerly Integromat).

Setup

1. In Make, create a new Scenario
2. Add a Webhooks > Custom webhook module
3. Click Add to create a new webhook
4. Copy the webhook URL
5. In NovaKit, connect Make with the webhook URL
6. Select your events

Use Cases

• Multi-step workflows: Chain multiple actions
• Data transformation: Process and format webhook data
• Conditional logic: Different actions based on event type
• Error handling: Retry failed operations

Example Scenario

[Webhook Trigger]
    ↓
[Router]
    ├── generation.completed → [Google Drive: Upload]
    ├── agent.run.completed → [Slack: Send Message]
    └── credits.low → [Email: Send Alert]

n8n Integration

Self-hosted workflow automation for maximum control.

Setup

1. In n8n, create a new Workflow
2. Add a Webhook node
3. Configure the webhook settings
4. Copy the Production URL
5. In NovaKit, connect n8n with the webhook URL

Configuration

{
  "webhookUrl": "https://your-n8n.example.com/webhook/novakit",
  "notifyOnEvents": [
    "generation.completed",
    "agent.run.completed"
  ]
}

Features

• Self-hosted: Keep data on your own infrastructure
• Open source: Full control and customization
• No limits: No execution limits like SaaS alternatives
• Custom nodes: Build your own integrations

Event Payloads

All integrations receive standardized event payloads:

{
  "id": "evt_abc123",
  "type": "generation.completed",
  "timestamp": "2025-01-15T10:30:00Z",
  "orgId": "org_xyz789",
  "data": {
    // Event-specific data
  }
}

See Webhooks Documentation for detailed event payloads.

Managing Integrations

Enable/Disable

Toggle integrations without removing them:

1. Go to Settings → Integrations → Connectors
2. Click on the integration
3. Toggle the Enabled switch

Update Events

Change which events trigger notifications:

1. Click on the connected integration
2. Check/uncheck events in the Events section
3. Click Save Changes

Disconnect

Remove an integration completely:

1. Click on the connected integration
2. Click Disconnect
3. Confirm the action

API Access

Manage integrations programmatically via the API:

List Integrations

curl https://www.novakit.ai/api/v1/integrations \
  -H "Authorization: Bearer sk_your_api_key"

Create Integration

curl -X POST https://www.novakit.ai/api/v1/integrations \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "discord",
    "credentials": {
      "webhookUrl": "https://discord.com/api/webhooks/..."
    },
    "config": {
      "username": "NovaKit Bot",
      "notifyOnEvents": ["generation.completed"]
    }
  }'

Update Integration

curl -X PATCH https://www.novakit.ai/api/v1/integrations/{id} \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "config": {
      "notifyOnEvents": ["generation.completed", "credits.low"]
    }
  }'

Delete Integration

curl -X DELETE https://www.novakit.ai/api/v1/integrations/{id} \
  -H "Authorization: Bearer sk_your_api_key"

Best Practices

1. Filter Events

Only subscribe to events you need. Too many notifications lead to alert fatigue.

2. Use Dedicated Channels

Create a dedicated Slack/Discord channel for NovaKit notifications to avoid noise in main channels.

3. Test Before Production

Use the "Test" feature to verify your integration works before relying on it.

4. Monitor Delivery

Check the delivery logs for failed notifications and fix issues promptly.

5. Secure Webhook URLs

Treat webhook URLs as secrets. Regenerate them if compromised.

Limits by Plan

Troubleshooting

Notifications Not Arriving

1. Check the integration is enabled
2. Verify the webhook URL is correct
3. Check delivery logs for errors
4. Ensure the event type is selected

Slack OAuth Failed

1. Ensure you have permission to install apps
2. Try logging out and back in to Slack
3. Contact your Slack admin if workspace restrictions apply

Discord Webhook Invalid

1. Verify the webhook still exists in Discord
2. Check the webhook URL format is correct
3. Regenerate the webhook in Discord and update NovaKit

Rate Limits

Integration webhooks are subject to the target platform's rate limits. If you're hitting limits:

• Reduce the number of events
• Use filtering to only send important events
• Consider batching notifications