> For the complete documentation index, see [llms.txt](https://closingdealz.gitbook.io/product-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://closingdealz.gitbook.io/product-docs/developers/api-endpoints/contact-request-object.md).

# Contact Request Object

### **Contact Record Fields**

This section outlines the fields available for creating or updating a **Contact Record** in the **ClosingDealz CRM** through the API. Each field includes its expected data type, whether it is required or optional, and any specific constraints.

***

### **Fields**

| **Field Name** | **Data Type**        | **Description**                                                                 | **Constraints** |
| -------------- | -------------------- | ------------------------------------------------------------------------------- | --------------- |
| `name`         | Optional, `string`   | The first name of the contact.                                                  | Max length: 256 |
| `lastName`     | Optional, `string`   | The last name of the contact.                                                   | Max length: 256 |
| `email`        | Optional, `string`   | The email address of the contact.                                               | Max length: 124 |
| `phoneNumber`  | Optional, `string`   | The phone number of the contact.                                                | Max length: 64  |
| `address`      | Optional, `string`   | The physical address of the contact.                                            | Max length: 256 |
| `website`      | Optional, `string`   | The website URL associated with the contact.                                    | Max length: 512 |
| `linkedIn`     | Optional, `string`   | The LinkedIn profile URL of the contact.                                        | Max length: 512 |
| `twitter`      | Optional, `string`   | The Twitter handle of the contact.                                              | Max length: 512 |
| `facebook`     | Optional, `string`   | The Facebook profile URL of the contact.                                        | Max length: 512 |
| `role`         | Optional, `string`   | The role or title of the contact within their organization.                     | Max length: 64  |
| `dateCreated`  | Optional, `datetime` | The date the contact was created or captured. Defaults to the current UTC date. |                 |

***

### **Example JSON Payload for Creating or Updating a Contact**

```json
{
  "name": "Jane",
  "lastName": "Smith",
  "email": "jane.smith@acmecorp.com",
  "phoneNumber": "+1234567890",
  "address": "456 Elm Street, Business City, BC 54321",
  "website": "https://www.janesmith.com",
  "linkedIn": "https://www.linkedin.com/in/janesmith",
  "twitter": "@janesmith",
  "facebook": "https://www.facebook.com/janesmith",
  "role": "Marketing Manager",
  "dateCreated": "2024-03-15T08:00:00Z"
}
```