Overview
The Supabase Connection is Minimo’s native integration for PostgreSQL and Supabase databases. It reads your user data directly from your database in read-only mode, keeping your Minimo contacts automatically in sync — with zero code and zero API calls.Why use the native connection
| Native Connection | API Sync | |
|---|---|---|
| Setup | Plug-and-play | Requires code |
| Maintenance | None | You maintain the sync logic |
| Failure points | None (direct DB read) | API calls can fail |
| Data location | Stays in your database | Sent via HTTP requests |
| Real-time | Automatic sync | Depends on your implementation |
| Code required | None | Yes |
How it works
Connect your database
Provide your PostgreSQL or Supabase connection details. Minimo connects in read-only mode — it will never write to or modify your database.
Map your data
Tell Minimo which table contains your users and how fields map to Minimo contacts (email, phone, name, custom fields).
What gets synced
- Contact fields: email, phone, first name, last name
- Custom fields: any column in your users table can be mapped to a Minimo custom field
- Status: map a column to track active/inactive/churned status
Your data stays entirely in your infrastructure. Minimo reads it in real-time but never stores a copy of your database.
Requirements
- A PostgreSQL database (including Supabase, Neon, Railway, or any PostgreSQL-compatible provider)
- Read-only database credentials for Minimo
- Network access from Minimo’s servers to your database (IP allowlisting may be required)
Get started
The Supabase Connection is set up by the Minimo team for your account. Contact us to get started:Set up your connection
Email [email protected] and we’ll configure the native connection for your database.
FAQ
Is my data safe?
Is my data safe?
Minimo connects in read-only mode. It cannot modify, delete, or write any data to your database. The connection credentials should be configured with read-only permissions.
Does it work with any PostgreSQL database?
Does it work with any PostgreSQL database?
Yes. While we call it the “Supabase Connection”, it works with any PostgreSQL-compatible database — Supabase, Neon, Railway, AWS RDS, DigitalOcean, self-hosted, etc.
Can I use both the native connection and API sync?
Can I use both the native connection and API sync?
Yes, but it’s usually not needed. The native connection handles contact sync automatically. You might still use the API for specific actions like sending messages.