# 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"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://closingdealz.gitbook.io/product-docs/developers/api-endpoints/contact-request-object.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.