Skip to main content

Integrations Overview

Connect INSTROC to external services to add payments, email, and other capabilities to your apps.

Available Integrations​

IntegrationCategoryDescription
StripePaymentsAccept payments and manage subscriptions
ResendEmailSend transactional and marketing emails
SupabaseBackendDatabase, auth, and storage

More integrations coming soon.

How Integrations Work​

1. Connect Your Account​

  1. Go to Project Settings → Integrations
  2. Find the integration you want
  3. Click Connect
  4. Enter your API credentials
  5. Save the connection

2. Use in Your App​

Once connected, use the integration via AI or code:

AI:

Add a checkout button that creates a Stripe payment for $29

Code:

import { stripe } from '@/lib/integrations/stripe';

const session = await stripe.checkout.sessions.create({
  line_items: [{ price: 'price_xxx', quantity: 1 }],
  mode: 'payment',
  success_url: '/success',
  cancel_url: '/cancel',
});

3. Environment Variables​

Integration credentials are stored securely as environment variables:

STRIPE_SECRET_KEY=sk_live_xxx
STRIPE_PUBLISHABLE_KEY=pk_live_xxx
RESEND_API_KEY=re_xxx

These are automatically available in your code.

Security​

Credential Storage​

  • All credentials encrypted at rest
  • Never exposed in frontend code
  • Accessible only in server-side code

API Key Best Practices​

  • Use production keys only for live deployments
  • Use test keys during development
  • Rotate keys if compromised
  • Set appropriate permissions/scopes

Integration by Use Case​

Accept Payments​

Use Stripe for:

  • One-time payments
  • Subscriptions
  • Payment links
  • Invoicing

Send Emails​

Use Resend for:

  • Transactional emails (receipts, confirmations)
  • Marketing emails (newsletters)
  • Password reset emails
  • Notification emails

Store Data​

Use Supabase (built-in) for:

  • User data
  • Application data
  • File storage
  • Real-time updates

Adding Integrations via AI​

The AI can set up integrations for you:

Add Stripe payment processing. When users click "Buy Now"
on a product, take them to Stripe checkout.
When a user signs up, send them a welcome email using Resend.
Create a newsletter signup form that saves to the database
and sends a confirmation email.

Testing Integrations​

Use Test Mode​

Most integrations offer test/sandbox modes:

  • Stripe: Use sk_test_ keys
  • Resend: Test emails to verified domains

Verify in Dashboard​

Check the integration provider's dashboard to confirm:

  • API calls are being made
  • Events are being processed
  • Errors are being logged

Troubleshooting​

Connection Failed​

  • Verify API key is correct (no extra spaces)
  • Check key permissions
  • Ensure key is for the right environment (test vs live)

Integration Not Working​

  • Check environment variables are set
  • Verify the integration is enabled
  • Review server logs for errors

Rate Limiting​

  • Some APIs have request limits
  • Check provider documentation
  • Implement caching where appropriate

Coming Soon​

We're working on integrations for:

  • Auth0 - Advanced authentication
  • Twilio - SMS and voice
  • OpenAI - AI features
  • Cloudinary - Image optimization
  • Algolia - Search
  • Segment - Analytics

Request an integration in our feedback channel!