Skip to main content

Supabase

Prefer guided AI setup?

Instead of following these steps manually, you can use the AI Credential Assistant — describe what you want to connect and the AI will walk you through the setup step by step, tailored to your account.

Overview​

Connect your Supabase project to Nirvai to automate database operations, storage management, and backend services.

Supported Authentication Methods​

  • Service Role Key - Full access to all Supabase services (recommended for server-side)
  • Anon Key - Limited access respecting Row Level Security

Prerequisites​

  • A Supabase account
  • An existing Supabase project

Setup Instructions​

  1. Log in to your Supabase Dashboard
  2. Select or create your project
  3. Go to Project Settings (gear icon in sidebar)
  4. Select API in the left menu
  5. Find the following values:
    • Project URL: Copy the URL (e.g., https://xxxxx.supabase.co)
    • Service Role Key: Copy the service_role secret key (NOT the anon key)
  6. In Nirvai, enter:
    • Project URL: Paste your project URL
    • API Key: Paste your Service Role Key

Important Security Notes​

Service Role Key:

  • Bypasses Row Level Security (RLS)
  • Has full access to all data
  • Should NEVER be exposed in client-side code
  • Perfect for server-side automation

Anon Key:

  • Respects Row Level Security policies
  • Limited access based on your RLS rules
  • Safe for client-side use
  • Use only if RLS is properly configured

Configuration Fields​

FieldDescriptionExample
Project URLYour Supabase project URLhttps://abcdef.supabase.co
API KeyService Role or Anon keyeyJhbG...

Available Operations​

With Supabase credentials, you can:

  • Query and modify database tables
  • Manage storage buckets and files
  • Invoke Edge Functions
  • Manage user authentication
  • Access Realtime features

Troubleshooting​

Common Issues​

  • 401 Unauthorized: Invalid API key. Double-check you're using the correct key.
  • 403 Forbidden (with Anon key): RLS policies blocking access. Check your policies.
  • Connection Error: Verify the Project URL is correct.
  • Project not found: Ensure the project exists and hasn't been paused.

Paused Projects​

Free-tier Supabase projects are paused after 7 days of inactivity:

  1. Log in to Supabase Dashboard
  2. Select the paused project
  3. Click Restore project
  4. Wait for restoration to complete

Finding Your Keys​

If you can't find your keys:

  1. Go to Project Settings > API
  2. Keys are under "Project API keys"
  3. Click the eye icon to reveal the full key

Adapted from n8n documentation for Nirvai platform

Next Steps​

Got your credential? Connect it to an agent

Use the AI Tool Creator to turn this credential into agent-callable tools. Describe what your agent should be able to do and the AI investigates the API, configures the endpoints, and gives you a reviewable toolkit before saving anything.