> ## 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.