Skip to main content

​
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.
This is the recommended way to sync contacts if your application uses PostgreSQL or Supabase. It’s simpler, more reliable, and requires no maintenance.

​
Why use the native connection

​
How it works

1

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.
2

Map your data

Tell Minimo which table contains your users and how fields map to Minimo contacts (email, phone, name, custom fields).
3

Automatic sync

Minimo continuously reads your database and keeps contacts in sync. New users are created, updated users are updated — automatically.

​
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 info@minimo.it and we’ll configure the native connection for your database.

​
FAQ

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.
Yes. While we call it the “Supabase Connection”, it works with any PostgreSQL-compatible database — Supabase, Neon, Railway, AWS RDS, DigitalOcean, self-hosted, etc.
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.
Use the API Sync approach instead. You can also give our AI Prompt to your coding assistant to implement it quickly.