# Customers

The Customer object supports the storage of a defined set and custom attributes relating to your customers.

### Portal View

#### Accessing Customers&#x20;

Assess the Customers screen in the console via the console navigation bar.

![](/files/-M5oRyu0PlytpNFOE6jQ)

#### Add New Customers

Click Add New to create a new customer.

![](/files/-M5oS5b69y0doNnxvWuC)

Specify a First Name. Last Name, Display Name and Email Address.

<div align="left"><img src="/files/-M5oUJWHES6mmk7rKF9m" alt=""></div>

Click **Submit**.

#### Edit Customers

Customers can be accessed by clicking on the main customer screen:

<div align="left"><img src="/files/-M5oUynsZvEyZKR0-Vgk" alt=""></div>

Customer Details can be edited.

<div align="left"><img src="/files/-M5oUjNOCO1JIhUQ3Cmq" alt=""></div>

Click **Save** to commit your modifications.

Customers can be deleted by clicking the **Delete** button.

### Customer Properties

{% tabs %}
{% tab title="Attributes" %}

| Element                       | Description                                                                |
| ----------------------------- | -------------------------------------------------------------------------- |
| customerId                    | A unique identifier for the Customer (Guid/UUID)                           |
| version                       | A incremental version number tracking modifications to the Customer object |
| firstName                     | Customer First Name                                                        |
| lastName                      | Customer Last Name                                                         |
| displayName                   | Customer Display Name                                                      |
| emailAddress                  | Customer Email Address in                                                  |
| phones\[]                     | An array of Phone numbers                                                  |
| phones\[].Key                 | A unique identifier for the Phone Number (Guid/UUID)                       |
| phones\[].Type                | Unknown, Phone, Mobile                                                     |
| phones\[].Country             | ISO Country Code                                                           |
| phones\[].NumberLocal         | Phone Number in Local format                                               |
| phones\[].NumberInternational | Phone Number in International format                                       |
| addresses\[]                  | An array of address(es)                                                    |
| addresses\[].Key              | A unique identifier for the Address (Guid/UUID)                            |
| addresses\[].Address1         | Address Line 1                                                             |
| addresses\[].Address2         | Address Line 2                                                             |
| addresses\[].Suburb           | Suburb                                                                     |
| addresses\[].PostCode         | Postal Code/Zip Code                                                       |
| addresses\[].State            | State/Province/Region                                                      |
| addresses\[].Country          | Country                                                                    |
| attributes                    | Attributes are a list of Key/Value to support customisation of a Customer  |
| {% endtab %}                  |                                                                            |

{% tab title="Sample Object" %}

```
{
  "customerId": "string",
  "version": "string",
  "firstName": "string",
  "lastName": "string",
  "displayName": "string",
  "emailAddress": "string",
  "phones": [
    {
      "key": "string",
      "type": "Unknown",
      "country": "string",
      "numberLocal": "string",
      "numberInternational": "string"
    }
  ],
  "addresses": [
    {
      "key": "string",
      "address1": "string",
      "address2": "string",
      "suburb": "string",
      "postcode": "string",
      "state": "string",
      "country": "string"
    }
  ],
  "attributes": {}
}
```

{% endtab %}
{% endtabs %}


---

# 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://docs.simplestore.io/concepts/customers.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.
