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

# Deals

> An object to represent deals involving people & companies

```yaml Deal configuration theme={"system"}
api_slug: deals
singular_noun: Deal
plural_noun: Deal
```

The Deal object is available in every Attio workspace, but disabled by default. It can only be activated by a workspace admin, in the [objects settings](https://app.attio.com/_/settings/data/objects) page.

## Writeable attributes

| Attribute | Slug | Type | Traits |
| - | - | - | - |
| Name | `name` | [Text](/rest-api/attribute-types/attribute-types-text) | Required |
| Deal stage | `stage` | [Status](/rest-api/attribute-types/attribute-types-status) | Required - by default one of `"Lead"`, `"In Progress"`, `"Won 🎉"`, `"Lost"` (workspaces can configure these status options) |
| Deal owner | `owner` | [Actor reference](/rest-api/attribute-types/attribute-types-actor-reference) | Required |
| Deal value | `value` | [Currency](/rest-api/attribute-types/attribute-types-currency) | Defaults to USD, can be changed |
| Associated people | `associated_people` | [Record reference](/rest-api/attribute-types/attribute-types-record-reference) | Relationship, inverse of `Person -> associated_deals` |
| Associated company | `associated_company` | [Record reference](/rest-api/attribute-types/attribute-types-record-reference) | Relationship, inverse of `Company -> associated_deals` |

Note that deals do not have a unique attribute by default. This means that they cannot be automatically asserted without adding an additional unique attribute.


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