Sim

Supabase

Use Supabase database

Supabase is a powerful open-source backend-as-a-service platform that provides developers with a suite of tools to build, scale, and manage modern applications. Supabase offers a fully managed PostgreSQL database, robust authentication, instant RESTful and GraphQL APIs, real-time subscriptions, file storage, and edge functions—all accessible through a unified and developer-friendly interface. Its open-source nature and compatibility with popular frameworks make it a compelling alternative to Firebase, with the added benefit of SQL flexibility and transparency.

Why Supabase?

  • Instant APIs: Every table and view in your database is instantly available via REST and GraphQL endpoints, making it easy to build data-driven applications without writing custom backend code.
  • Real-time Data: Supabase enables real-time subscriptions, allowing your apps to react instantly to changes in your database.
  • Authentication & Authorization: Built-in user management with support for email, OAuth, SSO, and more, plus row-level security for granular access control.
  • Storage: Securely upload, serve, and manage files with built-in storage that integrates seamlessly with your database.
  • Edge Functions: Deploy serverless functions close to your users for low-latency custom logic.

Using Supabase in Sim

Sim’s Supabase integration makes it effortless to connect your agentic workflows to your Supabase projects. With just a few configuration fields—your Project ID, Table name, and Service Role Secret—you can securely interact with your database directly from your Sim blocks. The integration abstracts away the complexity of API calls, letting you focus on building logic and automations.

Key benefits of using Supabase in Sim:

  • No-code/low-code database operations: Query, insert, update, and delete rows in your Supabase tables without writing SQL or backend code.
  • Flexible querying: Use PostgREST filter syntax to perform advanced queries, including filtering, ordering, and limiting results.
  • Seamless integration: Easily connect Supabase to other tools and services in your workflow, enabling powerful automations such as syncing data, triggering notifications, or enriching records.
  • Secure and scalable: All operations use your Supabase Service Role Secret, ensuring secure access to your data with the scalability of a managed cloud platform.

Whether you’re building internal tools, automating business processes, or powering production applications, Supabase in Sim provides a fast, reliable, and developer-friendly way to manage your data and backend logic—no infrastructure management required. Simply configure your block, select the operation you need, and let Sim handle the rest.

Usage Instructions

Integrate Supabase into the workflow. Supports database operations (query, insert, update, delete, upsert), full-text search, RPC functions, row counting, vector search, and complete storage management (upload, download, list, move, copy, delete files and buckets).

Tools

supabase_query

Query data from a Supabase table

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to query
filterstringNoPostgREST filter (e.g., "id=eq.123")
orderBystringNoColumn to order by (add DESC for descending)
limitnumberNoMaximum number of rows to return
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of records returned from the query

supabase_insert

Insert data into a Supabase table

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to insert data into
dataarrayYesThe data to insert (array of objects or a single object)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of inserted records

supabase_get_row

Get a single row from a Supabase table based on filter criteria

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to query
filterstringYesPostgREST filter to find the specific row (e.g., "id=eq.123")
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray containing the row data if found, empty array if not found

supabase_update

Update rows in a Supabase table based on filter criteria

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to update
filterstringYesPostgREST filter to identify rows to update (e.g., "id=eq.123")
dataobjectYesData to update in the matching rows
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of updated records

supabase_delete

Delete rows from a Supabase table based on filter criteria

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to delete from
filterstringYesPostgREST filter to identify rows to delete (e.g., "id=eq.123")
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of deleted records

supabase_upsert

Insert or update data in a Supabase table (upsert operation)

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to upsert data into
dataarrayYesThe data to upsert (insert or update) - array of objects or a single object
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of upserted records

supabase_count

Count rows in a Supabase table

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to count rows from
filterstringNoPostgREST filter (e.g., "status=eq.active")
countTypestringNoCount type: exact, planned, or estimated (default: exact)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
countnumberNumber of rows matching the filter

Perform full-text search on a Supabase table

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
tablestringYesThe name of the Supabase table to search
columnstringYesThe column to search in
querystringYesThe search query
searchTypestringNoSearch type: plain, phrase, or websearch (default: websearch)
languagestringNoLanguage for text search configuration (default: english)
limitnumberNoMaximum number of rows to return
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of records matching the search query

Perform similarity search using pgvector in a Supabase table

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
functionNamestringYesThe name of the PostgreSQL function that performs vector search (e.g., match_documents)
queryEmbeddingarrayYesThe query vector/embedding to search for similar items
matchThresholdnumberNoMinimum similarity threshold (0-1), typically 0.7-0.9
matchCountnumberNoMaximum number of results to return (default: 10)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of records with similarity scores from the vector search. Each record includes a similarity field (0-1) indicating how similar it is to the query vector.

supabase_rpc

Call a PostgreSQL function in Supabase

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
functionNamestringYesThe name of the PostgreSQL function to call
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsjsonResult returned from the function

supabase_storage_upload

Upload a file to a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathstringYesThe path where the file will be stored (e.g., "folder/file.jpg")
fileContentstringYesThe file content (base64 encoded for binary files, or plain text)
contentTypestringNoMIME type of the file (e.g., "image/jpeg", "text/plain")
upsertbooleanNoIf true, overwrites existing file (default: false)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsobjectUpload result including file path and metadata

supabase_storage_download

Download a file from a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathstringYesThe path to the file to download (e.g., "folder/file.jpg")
fileNamestringNoOptional filename override
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
filefileDownloaded file stored in execution files

supabase_storage_list

List files in a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathstringNoThe folder path to list files from (default: root)
limitnumberNoMaximum number of files to return (default: 100)
offsetnumberNoNumber of files to skip (for pagination)
sortBystringNoColumn to sort by: name, created_at, updated_at (default: name)
sortOrderstringNoSort order: asc or desc (default: asc)
searchstringNoSearch term to filter files by name
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of file objects with metadata

supabase_storage_delete

Delete files from a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathsarrayYesArray of file paths to delete (e.g., ["folder/file1.jpg", "folder/file2.jpg"])
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of deleted file objects

supabase_storage_move

Move a file within a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
fromPathstringYesThe current path of the file (e.g., "folder/old.jpg")
toPathstringYesThe new path for the file (e.g., "newfolder/new.jpg")
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsobjectMove operation result

supabase_storage_copy

Copy a file within a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
fromPathstringYesThe path of the source file (e.g., "folder/source.jpg")
toPathstringYesThe path for the copied file (e.g., "folder/copy.jpg")
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsobjectCopy operation result

supabase_storage_create_bucket

Create a new storage bucket in Supabase

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the bucket to create
isPublicbooleanNoWhether the bucket should be publicly accessible (default: false)
fileSizeLimitnumberNoMaximum file size in bytes (optional)
allowedMimeTypesarrayNoArray of allowed MIME types (e.g., ["image/png", "image/jpeg"])
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsobjectCreated bucket information

supabase_storage_list_buckets

List all storage buckets in Supabase

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsarrayArray of bucket objects

supabase_storage_delete_bucket

Delete a storage bucket in Supabase

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the bucket to delete
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
resultsobjectDelete operation result

supabase_storage_get_public_url

Get the public URL for a file in a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathstringYesThe path to the file (e.g., "folder/file.jpg")
downloadbooleanNoIf true, forces download instead of inline display (default: false)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
publicUrlstringThe public URL to access the file

supabase_storage_create_signed_url

Create a temporary signed URL for a file in a Supabase storage bucket

Input

ParameterTypeRequiredDescription
projectIdstringYesYour Supabase project ID (e.g., jdrkgepadsdopsntdlom)
bucketstringYesThe name of the storage bucket
pathstringYesThe path to the file (e.g., "folder/file.jpg")
expiresInnumberYesNumber of seconds until the URL expires (e.g., 3600 for 1 hour)
downloadbooleanNoIf true, forces download instead of inline display (default: false)
apiKeystringYesYour Supabase service role secret key

Output

ParameterTypeDescription
messagestringOperation status message
signedUrlstringThe temporary signed URL to access the file

Notes

  • Category: tools
  • Type: supabase
On this page

On this page

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started