Skip to content

Supabase

Interact with a Supabase database from your workflow. Four node types are available for different operations. All require a Supabase connection.

Supabase uses PostgreSQL under the hood, so these nodes behave identically to the PostgreSQL nodes and include the same Schema field for working with non-default schemas.

Supabase Query

Execute a SELECT query on a Supabase table.

Configuration

FieldDescriptionNotes
Supabase ConnectionThe Supabase connection to useRequired. Select from your configured Supabase connections.
OperationChoose how many rows to returnGet Many (default) returns multiple rows. Get One returns only the first matching row.
TableThe table to queryRequired. Select from tables available in the connected database.
ColumnsWhich columns to include in the resultsLeave empty to return all columns.
WhereFilter conditions to narrow down resultsSee Where Conditions below.

Get Many Options

These fields appear only when Operation is set to Get Many:

FieldDescriptionNotes
Order ByColumn to sort results byOptional.
DirectionSort directionAscending (default) or Descending.
LimitMaximum number of rows to returnOptional. Must be at least 1.
OffsetNumber of rows to skipOptional. Useful for pagination.

Additional Options

FieldDescriptionNotes
SchemaThe database schema to useDefaults to public. Change this if your tables live in a different schema.
Output Decimals as NumbersConvert string-encoded decimal values to numbersDisabled by default.
Show Query Plan (EXPLAIN)Return the query execution plan instead of resultsDisabled by default. Useful for debugging slow queries.

Output

Get Many returns a list of row objects. Get One returns a single row object, or an empty object if no match is found.

When Show Query Plan is enabled, the output contains a query_plan field with the execution plan instead of the actual query results.


Supabase Insert

Insert data into a Supabase table.

Configuration

FieldDescriptionNotes
Supabase ConnectionThe Supabase connection to useRequired.
TableThe table to insert intoRequired.
Column MappingMap input data to table columnsEach entry maps a table column to a value from upstream data.
On ConflictWhat to do when a duplicate key is detectedRaise Error (default), Ignore (Skip), or Update Existing.
Conflict ColumnsColumns that determine uniquenessAppears when On Conflict is Ignore or Update Existing.
SchemaThe database schemaDefaults to public.

Output

FieldDescription
successtrue if the insert succeeded
tableThe name of the table
inserted_dataThe full inserted row (returned via RETURNING *)
insert_idThe auto-generated ID (if applicable)

Supabase Update

Update data in a Supabase table.

Configuration

FieldDescriptionNotes
Supabase ConnectionThe Supabase connection to useRequired.
TableThe table to updateRequired.
Update Fields MappingMap new values to table columnsEach entry maps a column to the new value.
WHERE ConditionsFilter which rows to updateSee Where Conditions below.
Allow NULL ValuesWhether to include null or empty valuesDisabled by default. When disabled, null/empty mapped values are skipped.
Require WHERE ConditionsWhether WHERE conditions are mandatoryEnabled by default.
SchemaThe database schemaDefaults to public.

Output

FieldDescription
successtrue if the update succeeded
tableThe name of the table
affected_rowsNumber of rows updated
updated_dataThe values that were set

Supabase Delete

Delete data from a Supabase table.

Configuration

FieldDescriptionNotes
Supabase ConnectionThe Supabase connection to useRequired.
TableThe table to delete fromRequired.
WHERE ConditionsFilter which rows to deleteSee Where Conditions below.
Require WHERE ConditionsWhether WHERE conditions are mandatoryEnabled by default.
SchemaThe database schemaDefaults to public.

Output

FieldDescription
successtrue if the delete succeeded
tableThe name of the table
affected_rowsNumber of rows deleted

Where Conditions

All Supabase nodes use the same visual condition builder. Each condition has three parts:

  • Column -- The column to filter on.
  • Operation -- The comparison operator: equals, not equals, greater than, less than, greater than or equals, less than or equals, contains, starts with, ends with, in, not in, is null, is not null, is empty, is not empty.
  • Value -- The value to compare against. Supports expressions that reference upstream node data.

Multiple conditions can be combined with AND or OR logic.

WARNING

Disabling Require WHERE Conditions on Update or Delete nodes allows the operation to affect every row in the table. Use with caution.

TIP

Supabase projects often use Row Level Security (RLS). Make sure the database credentials in your Supabase connection have sufficient privileges to perform the operations you need. Using the service_role key bypasses RLS.