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

# Import from a tool

> Add rows from a tool you already use. Pick an integration and an object, check the sample rows, then choose which fields become columns.

Bring contacts or companies in from a tool you already use. Oneprofile shows you real sample rows first, so you can see what comes back before you make the table.

<Frame caption="The import drawer, with an integration and object picked.">
  <img src="https://mintcdn.com/oneprofile/lY44hLLJDpJofsIR/images/tables/import-from-a-tool.png?fit=max&auto=format&n=lY44hLLJDpJofsIR&q=85&s=0e5cf94296a0ecd51a7f54026587384b" alt="The Import from a connected tool drawer showing an Integration and an Object dropdown, chips counting the object's fields and how it reloads, Table name and Rows to import fields, a Sample rows table, and an Output list of fields with checkboxes." width="600" height="830" data-path="images/tables/import-from-a-tool.png" />
</Frame>

## Add rows from a connected tool

<Steps>
  <Step title="Open the drawer">
    On [Tables](https://app.getoneprofile.ai/tables), choose the **Import from a connected tool** card. You can also click **New** and pick the same item.
  </Step>

  <Step title="Pick a connection and an object">
    Choose an **Integration**, then an **Object** to bring in, such as contacts or companies.
  </Step>

  <Step title="Set it up and create the table">
    Work through the drawer's fields below, then click **Create table**.
  </Step>
</Steps>

* **Sample rows** holds a few real rows pulled from that object. Every tool means something different by "contact", so this is worth a look.
* **Table name** is filled in from the integration and the object. Change it to whatever you will recognise later.
* **Rows to import** brings in everything when you leave it empty.
* **Output** decides which fields become their own columns. A line underneath counts them.

Every row keeps the whole object either way. A field you left unchecked is one click from becoming a column later, straight from the row.

A [CSV import](/tables/import-a-csv) is a one-off. This table keeps a link to the tool it came from. That is why the drawer refuses an object with no stable identifier: a later refresh could not tell which row to update.

<Note>
  If nothing is connected yet, the drawer shows **Connect a source** instead. Search the directory and connect from there, without leaving the drawer.
</Note>

## Good to know

<AccordionGroup>
  <Accordion title="What does the Output section decide?">
    Each row holds the whole object in one column. Checked fields also get a column of their own, and everything else stays one click away when you open the row.

    Oneprofile suggests a few fields and lists them first, already checked. Change them freely. A long field list gets a **Filter fields** box above it, and the line under the list reads how many of the fields become columns.
  </Accordion>

  <Accordion title="How does the table refresh later?">
    Once the sample rows arrive, a chip counts the fields the object carries. A second chip says how this object reloads.

    **Only loads what changed** means later runs bring in just the differences. **Reloads everything each time** means they bring in the whole object again.
  </Accordion>

  <Accordion title="Why can't an object be imported?">
    Some objects carry no stable identifier. The drawer says so and blocks the import, because a refresh could not tell which row to update. Pick a different object.
  </Accordion>

  <Accordion title="Why isn't a tool I just connected listed?">
    The drawer only lists tools it can pull rows from, so a connection of another kind never appears. It tells you when that has happened: "Your new connection can't be imported from yet, so it isn't listed here."
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Connect a tool" icon="plug" href="/integrations/connect-a-tool">
    Browse the directory and connect a tool.
  </Card>

  <Card title="Enrichment columns" icon="sparkles" href="/tables/columns/enrichment-columns">
    Add columns that fill themselves in.
  </Card>

  <Card title="Create a table" icon="table" href="/tables/create-a-table">
    Every other way to start a table.
  </Card>
</CardGroup>
