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

# Base44

Let's learn how to connect Engini to Base44.

With this integration you can read and manage the data records, users and AI builder chat of your Base44 apps from your Engini workflows.

To get started, create an account at [Base44](https://base44.com/).

## Add a Connection to Base44 in Engini

### Prerequisites

* A Base44 account.
* A Base44 personal access token with full access. A read-only token can't create, update or delete records, invite users, run workflows or send messages.
* Only for the *App Event* trigger: a Base44 workspace API key with the "Manage outbound webhooks" permission (see [Creating a workspace API key](#creating-a-workspace-api-key)).

#### Creating a workspace API key

The *App Event* trigger needs a Base44 workspace API key. Workspace API keys are available on Base44's Business and Enterprise plans, and only workspace owners and admins can create them.

1. In Base44, click your workspace name at the bottom left and click **Settings**.
2. Click **Secrets** in the sidebar.
3. Click **+ Create API Key**.
4. Enter a name for the key and select the **Manage outbound webhooks** permission.
5. Click **Create Key**, then copy the key and store it somewhere safe. Base44 shows it only once.
6. Paste the key into the *Workspace API Key* field of the Base44 connection in Engini.

For more details, see [Managing workspace secrets](https://docs.base44.com/Enterprise/workspace-secrets.md) in the Base44 documentation.

### Connecting Engini to Base44

1. Enter your Engini account at [https://app.engini.io](https://app.engini.io/).

2. Navigate to the Connections page by clicking on Connections in the left sidebar or by clicking [here](https://app.engini.io/connections).

   ![Engini - Connections page](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/connections-page.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=4de15aa3cdf37239b4b74ba1cc3a737a)

3. Click on the "New Integration" option located at the top bar.

   ![Engini - New Integration button](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/new-integration-button.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=27052db722ade562fddf298aed17f3d4)

4. Choose the Base44 option from the available applications.

   ![Base44 - Choose Application](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-choose-application.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=5e8b2c16de924a8720200d40be7f707b)

5. Enter the following details in the "New Integration" form and press Save:

   ![Base44 - New Integration form](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-new-integration.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=df91ee7ada26e29929296289be5719b4)

   <ol>
     <li>*Connection Name -* Enter a name that helps identify the Base44 connection, for example "Base44 - Main account".</li>
     <li>*Personal Access Token -* Enter the personal access token you created in your Base44 account. Engini sends it with every Base44 request made through this connection.</li>
     <li>*Workspace API Key -* Optional. Fill it in only if you use the *App Event* trigger, and leave it empty otherwise. Enter a Base44 workspace API key with the "Manage outbound webhooks" permission. To create one, follow the steps below.</li>
     <li>*Save -* Click Save to create the connection.</li>
   </ol>

## Triggers

### Check for New Records

Starts the workflow when new records are added to an entity of your Base44 app. Engini checks Base44 on the schedule you set.

![Base44 - Check for New Records trigger](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-check-for-new-records.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=7e26491ab7a5cd6ac76b74d752861c61)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Entity -* Choose the entity (the data table of the app) from the list that loads for the selected app, map an entity name from a previous step, or enter it as text. Select the App first so the list can load.
3. *Starting (UTC) -* Select the start date and time for the scheduled trigger.
4. *Recur every -* Choose the time interval for checking Base44. The minimum time interval is 15 minutes.
5. *Add time frame -* You can specify a time frame during which the trigger will operate.
6. *Add Conditions -* Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-conditions).

**What the trigger returns:** the new records it finds. Each record includes:

* *Record Id -* The Id of the record.
* *Created Date -* When the record was created.
* *Updated Date -* When the record was last updated.
* *Created By -* Who created the record.
* *Created By Id -* The Id of the user who created the record.
* *Is Sample -* Whether the record is sample data.

### Check for Updated Records

Starts the workflow when records of an entity are updated in your Base44 app. Engini checks Base44 on the schedule you set.

![Base44 - Check for Updated Records trigger](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-check-for-updated-records.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=6c4c73097c2cec22605ab776f11f420d)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Entity -* Choose the entity (the data table of the app) from the list that loads for the selected app, map an entity name from a previous step, or enter it as text. Select the App first so the list can load.
3. *Starting (UTC) -* Select the start date and time for the scheduled trigger.
4. *Recur every -* Choose the time interval for checking Base44. The minimum time interval is 15 minutes.
5. *Add time frame -* You can specify a time frame during which the trigger will operate.
6. *Add Conditions -* Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-conditions).

**What the trigger returns:** the updated records it finds. Each record includes the same properties as in *Check for New Records*: Record Id, Created Date, Updated Date, Created By, Created By Id and Is Sample.

### Superagent Message Event

Starts the workflow when Base44 reports a message event for one of your Superagents. It uses the personal access token of your Base44 connection and needs a Superagent in your Base44 account.

![Base44 - Superagent Message Event trigger](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-superagent-message-event.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=3d0ad393fbd4cebf23bade970619dc77)

1. *Superagent Id -* The Id of the Superagent to watch. Map it from a previous step or enter it as text.
2. *Event -* The message event that starts the workflow: Message created or Message completed. The field opens with `message.completed`; choose another event from the list or enter the event value as text.
3. *Add Conditions -* Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-conditions).

### App Event

Starts the workflow when Base44 reports an event for an app in your workspace. This trigger needs the *Workspace API Key* of the Base44 connection (see [Creating a workspace API key](#creating-a-workspace-api-key)).

![Base44 - App Event trigger](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-app-event.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=287e9c29f38e952cad77c664b298eb93)

1. *Event -* The app event that starts the workflow: App created, App published, App unpublished, App deleted, App restored, Chat turn started or Chat turn ended. The field opens with `app.created.v1`; choose another event from the list or enter the event value as text.
2. *Add Conditions -* Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-conditions).

**What the trigger returns:** the event. It includes:

* *Spec Version -* The version of the event format.
* *Event Id -* The Id of the event.
* *Source -* Where the event comes from.
* *Event Type -* The type of the event.
* *Subject -* What the event is about.
* *Time -* When the event happened.
* *Content Type -* The content type of the event data.
* *Data Schema -* The schema of the event data.
* *Auth Type* and *Auth Id -* The kind and Id of the credential behind the event.
* *Data -* The details of the event.

## Actions

Most Base44 actions start with the *App* field, and record actions also need an *Entity*. Both load as lists from your Base44 account once the connection is selected.

### Count Records

Returns the number of records in an entity.

![Base44 - Count Records action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-count-records.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=21c4d0a2294000097f1643796521b929)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Entity -* Choose the entity (the data table of the app) from the list that loads for the selected app, map an entity name from a previous step, or enter it as text. Select the App first so the list can load.
3. *Add Filter -* Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-filters).

Click Add Filter and choose *Filter* to count only the records that match a JSON filter on your entity's fields, for example `{"status": "open"}`.

### Create Record

Creates a single record in an entity of your Base44 app.

![Base44 - Create Record action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-create-record.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=5fb5e7c15fc1a572220853f4204600af)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Entity -* Choose the entity (the data table of the app) from the list that loads for the selected app, map an entity name from a previous step, or enter it as text. Select the App first so the list can load.
3. *Record -* The fields of the new record as JSON, using your entity's field names, for example `{"title": "Weekly report"}`. Map the JSON from a previous step or type it as text.

### Create Records

Creates several records in an entity of your Base44 app in one step.

![Base44 - Create Records action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-create-records.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=f3553d5f97ef1844b5d2b34a3898dc55)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Entity -* Choose the entity (the data table of the app) from the list that loads for the selected app, map an entity name from a previous step, or enter it as text. Select the App first so the list can load.
3. *Records -* A JSON array with one object per new record, using your entity's field names, for example `[{"title": "Task 1"}, {"title": "Task 2"}]`.

### Create Superagent Conversation

Creates the main conversation with a Base44 Superagent, or returns the existing one if it already exists, so you can send it messages. Calling it again for the same Superagent returns the same conversation. This action needs a Superagent in your Base44 account.

![Base44 - Create Superagent Conversation action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-create-superagent-conversation.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=1d93bcd65c0961a692d5746072de58b6)

1. *Superagent Id -* The Id of the Superagent. Map it from a previous step or enter it as text.
2. *Add Field -* Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-fields).

Click Add Field and choose the optional field *Metadata*.

* *Metadata -* Extra details to save with the new conversation, as key and value pairs, for example `source` as the key and `crm` as the value. They are saved only when the conversation is first created; if the conversation already exists, Metadata is ignored.

The action returns the Conversation Id, the Title and the created and updated dates. Use the Conversation Id in *Send Superagent Message*.

### Delete Record

Permanently deletes a record from an entity.

![Base44 - Delete Record action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-delete-record.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=af5befba8710afbd8837b1b3f2fdad09)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Entity -* Choose the entity (the data table of the app) from the list that loads for the selected app, map an entity name from a previous step, or enter it as text. Select the App first so the list can load.
3. *Record Id -* The Id of the record. Map it from a previous *Create Record*, *Get Record* or *Get Records* step, or enter it as text.

**Note:** Deleting a record can't be undone.

### Get App

Retrieves the details of one Base44 app.

![Base44 - Get App action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-get-app.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=b4c0ab51f59bf1bb803ba553197a7b4d)

* *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.

### Get Apps

Retrieves the Base44 apps that your connection can access.

![Base44 - Get Apps action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-get-apps.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=2eea160a0e7d6d0cc48d6c00ab9cf0fa)

1. *Top N -* You can set the maximum number of apps Engini will return (default = all apps).
2. *Add Filter -* Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-filters).

Click Add Filter and choose one of these fields:

* *Workspace Id -* The Id of the workspace whose apps you want. Leave it empty to use your own workspace.
* *Search -* Return only apps that match this text, for example an app name.
* *Folder Id -* Return only the apps in this folder, for example a folder Id.
* *Filter Mode -* The Base44 filter mode for the list of apps.
* *Sort By -* Choose the order: Newest first, Oldest first, Recently updated first or Least recently updated first.
* *Fields To Return -* A comma-separated list of the app properties to return, for example `id,name,slug`.

### Get Entity Schemas

Retrieves the entities of an app together with their field definitions, so you can see which fields each entity has.

![Base44 - Get Entity Schemas action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-get-entity-schemas.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=d728303e31c4f8db980ba9eec2f1299d)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Add Filter -* Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-filters).

Click Add Filter and choose *Branch Id* to read the entities of a specific branch of the app. Leave it empty for the main branch.

### Get Record

Retrieves a single record from an entity.

![Base44 - Get Record action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-get-record.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=da746dc7a5cd6172121d71e398f72585)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Entity -* Choose the entity (the data table of the app) from the list that loads for the selected app, map an entity name from a previous step, or enter it as text. Select the App first so the list can load.
3. *Record Id -* The Id of the record. Map it from a previous *Create Record*, *Get Record* or *Get Records* step, or enter it as text.

### Get Records

Retrieves the records of an entity. All matching records are returned unless you set Top N.

![Base44 - Get Records action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-get-records.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=fbba41541690589eeeac3d903200af02)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Entity -* Choose the entity (the data table of the app) from the list that loads for the selected app, map an entity name from a previous step, or enter it as text. Select the App first so the list can load.
3. *Top N -* You can set the maximum number of records Engini will return (default = all records).
4. *Add Filter -* Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-filters).

Click Add Filter and choose one of these fields:

* *Filter -* A JSON filter on your entity's fields, for example `{"status": "paid"}`.
* *Sort By -* Choose the order: Newest first, Oldest first, Recently updated first or Least recently updated first.
* *Fields To Return -* A comma-separated list of the field names to return, for example `id,status`.

### Get Superagent Conversation

Returns a conversation with a Base44 Superagent together with its latest messages (up to 200, oldest first). This action needs a Superagent in your Base44 account.

![Base44 - Get Superagent Conversation action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-get-superagent-conversation.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=016fdd6a99509baf2d93836e00e66751)

1. *Superagent Id -* The Id of the Superagent. Map it from a previous step or enter it as text.
2. *Conversation Id -* The Id of the conversation. Map it from a previous *Create Superagent Conversation* step or enter it as text.

The action returns the Conversation Id, the Title, the created and updated dates and the messages. Each message includes its Id, Role, Content, File Urls, created date and any tool calls.

### Get Superagent Conversations

Returns the conversations of a Base44 Superagent. There is at most one main conversation, so the list is empty until you create it with *Create Superagent Conversation*. This action needs a Superagent in your Base44 account.

![Base44 - Get Superagent Conversations action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-get-superagent-conversations.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=a49ad6eed59faabf869da408380a402c)

* *Superagent Id -* The Id of the Superagent. Map it from a previous step or enter it as text.

The action returns, for each conversation, the Conversation Id, the Title and the created and updated dates.

### Get User

Retrieves one user of a Base44 app.

![Base44 - Get User action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-get-user.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=a66bc07a15e29832e78461900711a9c4)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *User -* Choose the user from the list that loads for the selected app, map a user Id from a previous *Get Users* step, or enter it as text.

### Get Users

Retrieves the users of a Base44 app.

![Base44 - Get Users action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-get-users.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=41f0cb01439192e217ca666a879569d9)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Top N -* You can set the maximum number of users Engini will return (default = all users).
3. *Add Filter -* Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-filters).

Click Add Filter and choose one of these fields:

* *Filter -* A JSON filter on the user fields, for example `{"role": "admin"}`.
* *Sort By -* Choose the order: Newest first, Oldest first, Recently updated first or Least recently updated first.
* *Fields To Return -* A comma-separated list of the field names to return, for example `id,email`.

### Get Workflow Run

Retrieves the details of one run of a Base44 app workflow, such as its status, start and end time, duration and any error message.

![Base44 - Get Workflow Run action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-get-workflow-run.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=82431629e11999b809aa50c6da568bd4)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Workflow -* Choose the workflow from the list that loads for the selected app, map a workflow Id from a previous *Get Workflows* step, or enter it as text. Select the App first so the list can load.
3. *Run Id -* The Id of the run. Map it from a previous *Run Workflow* or *Get Workflow Runs* step, or enter it as text.

**Note:** Workflows are available in Base44 on the Builder plan and above.

### Get Workflow Runs

Retrieves the runs of a Base44 app workflow.

![Base44 - Get Workflow Runs action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-get-workflow-runs.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=82ff7d83a8dd0b676b5a2d0f6e272bb0)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Workflow -* Choose the workflow from the list that loads for the selected app, map a workflow Id from a previous *Get Workflows* step, or enter it as text. Select the App first so the list can load.
3. *Top N -* You can set the maximum number of runs Engini will return (default = all runs).
4. *Add Filter -* Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-filters).

Click Add Filter and choose one of these fields:

* *Status -* Return only runs with this status, for example `failed`.
* *Started Since -* Return only runs that started on or after this date and time.

**Note:** Workflows are available in Base44 on the Builder plan and above.

### Get Workflows

Retrieves the workflows of a Base44 app, with their status, number of runs and last run.

![Base44 - Get Workflows action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-get-workflows.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=1595b49ee01c1c73c4b89c9faccf5a52)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Top N -* You can set the maximum number of workflows Engini will return (default = all workflows).
3. *Add Filter -* Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-filters).

Click Add Filter and choose *Include Archived* to add archived workflows to the result.

**Note:** Workflows are available in Base44 on the Builder plan and above.

### Invite Users

Invites people to a Base44 app by email.

![Base44 - Invite Users action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-invite-users.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=44978d00c9c65c96b40f77a4f1bfe918)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Emails -* The email addresses to invite. Enter one email address per row, up to 50 addresses, for example `dana@company.com` in the first row and `lee@company.com` in the second. To invite a list you already have, map the list from a previous step instead. This field is required.
3. *Add Field -* Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-fields).

Click Add Field and choose one of these optional fields: *Role*, *Collaborator Role* or *Add As Guest*.

### Run Workflow

Starts a run of a Base44 app workflow right now and returns the Id of the new run.

![Base44 - Run Workflow action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-run-workflow.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=42a0fe74b3e8e59abc4d086b32a1ee31)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Workflow -* Choose the workflow from the list that loads for the selected app, map a workflow Id from a previous *Get Workflows* step, or enter it as text. Select the App first so the list can load.
3. *Replay From Run Id -* Optional. Enter the Id of an earlier run to replay it, only if the workflow asks for one. You can map the Id from a *Get Workflow Runs* step.

**Note:** Workflows are available in Base44 on the Builder plan and above.

### Send Chat Message

Sends a message to the Base44 AI builder of an app, asking it to build or change the app.

![Base44 - Send Chat Message action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-send-chat-message.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=a2af86f05e546a5cc06d96600f900c64)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Message -* The instruction for the builder, for example `Add a contact form`.
3. *Add Field -* Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-fields).

Click Add Field and choose one of these optional fields: *File Urls* or *Branch Id*.

**Note:** Each message uses Base44 message credits from your plan.

### Send Superagent Message

Sends a message to a Base44 Superagent in an existing conversation and returns the message. This action needs a Superagent in your Base44 account.

![Base44 - Send Superagent Message action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-send-superagent-message.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=4ff2cf609bf5a8cab79427576d6bfc39)

1. *Superagent Id -* The Id of the Superagent. Map it from a previous step or enter it as text.
2. *Conversation Id -* The Id of the conversation. Map it from a previous *Create Superagent Conversation* step or enter it as text.
3. *Message -* The message to send, for example `Summarize today's sales`.
4. *Add Field -* Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-fields).

Click Add Field and choose the optional *File Urls* field (public links to files).

### Update Record

Updates the fields of an existing record.

![Base44 - Update Record action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-update-record.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=0caf6b4d9a6b6fb4c3fa9873d778471f)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Entity -* Choose the entity (the data table of the app) from the list that loads for the selected app, map an entity name from a previous step, or enter it as text. Select the App first so the list can load.
3. *Record Id -* The Id of the record. Map it from a previous *Create Record*, *Get Record* or *Get Records* step, or enter it as text.
4. *Record -* The fields to change as JSON, for example `{"status": "done"}`. Fields you leave out stay as they are.

### Upsert Records

Creates or updates records in an entity in one step: a record that already matches on the key field is updated, any other is created.

![Base44 - Upsert Records action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-upsert-records.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=20cd653b06bf9dd2a71c479c78a385e7)

1. *App -* Choose the app from the list that loads from your Base44 account, map an App Id from a previous step, or enter it as text.
2. *Entity -* Choose the entity (the data table of the app) from the list that loads for the selected app, map an entity name from a previous step, or enter it as text. Select the App first so the list can load.
3. *Upsert Data -* JSON with the name of the key field and the records, for example `{"key": "email", "records": [{"email": "dana@company.com", "name": "Dana"}]}`.

### Send API Request

This activity allows you to send a custom API request directly to Base44's API.

![Base44 - Send API Request action](https://mintcdn.com/engini/fd2yNamTBaxRqXlh/help/assets/apps/base44/base44-send-api-request.png?fit=max\&auto=format\&n=fd2yNamTBaxRqXlh\&q=85\&s=26334482cfcae44fdc9cf209034bca32)

1. *Base Url -* The root URL of the Base44 API. It is filled in from your Base44 connection and can't be edited here.
2. *Relative url -* You can specify additional path segments or parameters that need to be added to the end of the Base Url. This allows you to customize the specific request you want to perform.
3. *Method -* Select the HTTP method (e.g., Get, Post, Put, Delete, Patch). The default is POST.
4. *Body Type -* Defines the format of the data in the body of your request. The default, application/json, means the body contains a JSON-formatted payload.
   * *application/json* – Sends the request body in JSON format. Commonly used by REST APIs.
   * *custom* – Allows you to define a custom body format by manually setting the Content-Type header. Add a `Content-Type` row in *Add Headers* with the media type you need (for example `application/xml`). With any other Body Type, a Content-Type you type in *Add Headers* is not sent; Engini sets it from the Body Type, and the run history shows it under `headersnotsent`.
   * *application/x-www-form-urlencoded* – Sends the body as URL-encoded key-value pairs, commonly used in form submissions.
   * *file* – Sends a file as the request body.
   * *multipart/form-data* – Sends form data that may include both text fields and files.
   * *text/html* – Sends the request body as HTML content.
   * *text/plain* – Sends the request body as plain text.
   * *text/xml* – Sends the request body in XML format.
5. *Body -* Contains any data that is being sent to the server.
6. *Add Headers -* Additional metadata about the request, such as the type of data Engini can accept, the length of the request body, and authentication information.
7. *Add Queries -* The query refers to the parameters or data that are included in the URL of an HTTP request to provide additional information or instructions to the server.

Your Base44 connection sends the personal access token with every request in an Authorization header.

For the full list of endpoints, see the [Base44 API reference](https://docs.base44.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.