> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minimo.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Supabase Connection

> Sync your contacts automatically with a native, plug-and-play database connection

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

<Tip>
  This is the **recommended** way to sync contacts if your application uses PostgreSQL or Supabase. It's simpler, more
  reliable, and requires no maintenance.
</Tip>

***

## 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

<Steps>
  <Step title="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.
  </Step>

  <Step title="Map your data">
    Tell Minimo which table contains your users and how fields map to Minimo contacts (email, phone, name, custom
    fields).
  </Step>

  <Step title="Automatic sync">
    Minimo continuously reads your database and keeps contacts in sync. New users are created, updated users are updated
    — automatically.
  </Step>
</Steps>

***

## 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

<Info>
  Your data stays entirely in your infrastructure. Minimo reads it in real-time but never stores a copy of your
  database.
</Info>

***

## 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:

<Card title="Set up your connection" icon="envelope" href="mailto:info@minimo.it">
  Email **[info@minimo.it](mailto:info@minimo.it)** and we'll configure the native connection for your database.
</Card>

***

## FAQ

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  {' '}

  <Accordion title="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.
  </Accordion>

  {' '}

  <Accordion title="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.
  </Accordion>

  <Accordion title="What if I need to sync data from a non-PostgreSQL database?">
    Use the [API Sync](/product/data-sync/api-sync) approach instead. You can also give our [AI Prompt](/guides/ai-prompts/contact-sync) to your coding assistant to implement it quickly.
  </Accordion>
</AccordionGroup>