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

# Deals

A [deal](https://help.folk.app/en/articles/9552366-track-deals) is an object you use to track opportunities, projects, or any other outcome‑driven item in folk. While people and companies describe who you're working with, deals capture what you're trying to achieve with them: for example, closing a new contract or finishing a freelance project.

## Deal fields

Every deal has the following native fields that are always present:

* `name`: The name of the deal.
* `people`: A list of people associated with the deal.
* `companies`: A list of companies associated with the deal.
* `createdAt`: The date and time the deal was created.
* `createdBy`: The user who created the deal.

<Info>
  You can also add custom fields to deals, which are additional attributes that
  can be defined in the deal's group. Read more about custom fields in the
  [Custom fields](/core-concepts/custom-fields) section.
</Info>

## Deal relationships

### People

A deal can reference one or more people shown in the `people` array.

<Card horizontal title="People" icon="user" href="/core-concepts/people">
  Read more about people <Icon icon="arrow-right" />
</Card>

### Companies

A deal can reference one or more companies shown in the `companies` array. Linking a company lets you keep its details separate while still measuring revenue or conversion per account.

<Card horizontal title="Companies" icon="building" href="/core-concepts/companies">
  Read more about companies <Icon icon="arrow-right" />
</Card>

### Group

Deals are created inside a group. They can only reference people and companies that belong to the same group.

<Card horizontal title="Groups" icon="users-viewfinder" href="/core-concepts/groups">
  Read more about groups <Icon icon="arrow-right" />
</Card>