Softr

Create, list, update, and delete records in Softr applications.

On this page

Connect
Call it from a workflow
Actions (7)
createAppUser
createDatabaseRecord
deleteAppUser
deleteDatabaseRecord
findDatabaseRecord
updateDatabaseRecord
custom_api_call
Details

Connect

Auth type: API key (secret_text). Paste the API key (or token) from the provider's settings into the connect dialog. It is encrypted at rest and only decrypted on the server when an action runs.

In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
For every project in a workspace: Workspace settings, Integrations.
Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.

Call it from a workflow

Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.

Native workflow

// .workflow.js (native ctx)
export async function run(ctx) {
  const res = await ctx.integrations.invoke("softr", "createAppUser", {
    "email": "<email>",
    "full_name": "<name>",
    "password": "<password>",
    "domain": "<domain>"
  });
  if (!res.success) throw new Error(res.error);
  ctx.log.info("Softr answered", { output: res.output });
}

defineWorkflow module

// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";

export default defineWorkflow({
  id: "softr-createappuser",
  name: "Softr: Create App User",
  description: "Calls Softr when a row is created.",
  trigger: { type: "entity_event", entity: "tickets", event: "created" },
  async run(ctx, event) {
    const res = await ctx.integrations.call("softr", {
      "action": "createAppUser",
      "email": "<email>",
      "full_name": "<name>",
      "password": "<password>",
      "domain": "<domain>"
    }) as { success: boolean; error?: string };
    if (!res.success) throw new Error(res.error);
  },
});

From an app (connector proxy)

curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/softr/createAppUser" \
  -H "Authorization: Bearer $APP_KEY" \
  -H "content-type: application/json" \
  -d '{"props":{"email":"<email>","full_name":"<name>","password":"<password>","domain":"<domain>"}}'

Actions

createAppUserin catalog

Create App User. Creates a new user inside a Softr app.

Input	Type	Description
`email`required	text	The email address of the new user.
`full_name`required	text	The full name of the new user.
`password`required	text	The password for the new user.
`domain`required	text	The domain or subdomain of the Softr app where the user will be created.
`generate_magic_link`optional	boolean	If checked, a magic link will be generated for the user.

createDatabaseRecordin catalog

Create Database Record. Creates a new record.

Input	Type	Description
`databaseId`required	id (picked from your account)	Select the database to insert the record into
`tableId`required	id (picked from your account)	Select the table to insert the record into
`fields`required	object (depends on other props)	Fields

deleteAppUserin catalog

Delete App User. Deletes a user from a Softr app.

Input	Type	Description
`email`required	text	The email address of the user to delete.
`domain`required	text	The domain or subdomain of the Softr app (e.g., yourdomain.com or subdomain.softr.app).

deleteDatabaseRecordin catalog

Delete Database Record. Deletes a existing database record.

Input	Type	Description
`databaseId`required	id (picked from your account)	Select the database to insert the record into
`tableId`required	id (picked from your account)	Select the table to insert the record into
`recordId`required	text	Record ID

findDatabaseRecordin catalog

Find Database Record. Finds a record in table.

Input	Type	Description
`databaseId`required	id (picked from your account)	Select the database to insert the record into
`tableId`required	id (picked from your account)	Select the table to insert the record into
`fieldId`required	id (picked from your account)	Field
`fieldValue`required	text	Field Value

updateDatabaseRecordin catalog

Update Database Record. Updates an existing database record.

Input	Type	Description
`databaseId`required	id (picked from your account)	Select the database to insert the record into
`tableId`required	id (picked from your account)	Select the table to insert the record into
`recordId`required	text	Record ID
`fields`required	object (depends on other props)	Fields

custom_api_call

Custom API Call. Make a custom API call to a specific endpoint

Input	Type	Description
`url`required	object (depends on other props)	url
`method`required	one of "GET" \| "POST" \| "PATCH" \| "PUT" \| "DELETE" \| "HEAD"	Method
`headers`required	object	Authorization headers are injected automatically from your connection.
`queryParams`required	object	Query Parameters
`body_type`optional	one of "none" \| "json" \| "form_data" \| "raw"	Body Type
`body`optional	object (depends on other props)	Body
`response_is_binary`optional	boolean	Enable for files like PDFs, images, etc.
`failsafe`optional	boolean	No Error on Failure
`timeout`optional	number	Timeout (in seconds)
`followRedirects`optional	boolean	Follow redirects

Details

Id: softr
Category: Content
Tags: no-code, apps, airtable, website
Package: @activepieces/piece-softr@0.1.4
Tier: Community