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

# Create Record

> Create new records in a connected external system

Creates new records in a connected integration. Use it to push data from your workflow into external systems - for example, creating Salesforce Accounts from a CSV import, or generating Linear issues from flagged records.

## Configuration

| Setting         | Description                                                                |
| --------------- | -------------------------------------------------------------------------- |
| **Integration** | The target system to create records in (e.g., Salesforce, HubSpot, Linear) |
| **Entity**      | The entity type to create (e.g., Account, Contact, Issue)                  |
| **Title**       | A human-readable description of the action (shown in task logs)            |
| **Fields**      | Map target fields to values using **Mentions** to reference upstream data  |

## How It Works

<Steps>
  <Step title="Select the target system">
    Choose which integration and entity to create records in.
  </Step>

  <Step title="Map fields">
    Define field mappings - for each target field, use **Mentions** to set the value from upstream data.
  </Step>

  <Step title="Set execution mode">
    Records are created automatically or queued for manual approval, depending on the Agent's execution mode.
  </Step>
</Steps>

## Output

Each created record generates one task in the Agent's task log.

<Note>
  By default, all matching records are batched into a single create action. To create one record per input row, add a [Group By](/guide/nodes/transform/group-by-node) node before this node, grouped by the primary key field.
</Note>

## Example

Import CSV contacts into Salesforce:

1. Use **Get Data** to load a CSV file
2. Add a **Create Record** node targeting Salesforce Contact
3. Map fields: `FirstName` → CSV.First Name, `LastName` → CSV.Last Name, `Email` → CSV.Email

## Best Practices

* Use a **Group By** node before this action to create one record per input row
* Start with manual approval to verify records are created correctly
* Use clear **Title** descriptions so task logs are easy to scan

## Related Nodes

* **[Update Record](/guide/nodes/actions/update-record-node)** - modifies existing records instead of creating new ones
* **[Group By](/guide/nodes/transform/group-by-node)** - controls batching so each input row creates a separate record