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

# Overview

## Contact object

A contact represents an individual in your Qomon space. Contact data is split into basic fields and advanced fields.

## Basic fields

Basic fields are simple key-value pairs for core contact information:

```json theme={"system"}
{
  "firstname": "John",
  "surname": "Doe",
  "mail": "john.doe@example.com",
  "mobile": "0123456789",
  "address": {
    "housenumber": "123",
    "street": "Rue de la paix",
    "city": "Paris",
    "country": "France"
  },
  "tags": ["important", "vip"]
}
```

## Advanced fields

Advanced fields store structured information such as consents, survey answers, custom fields, presence status, level of support, and tasks.

When you retrieve contacts, advanced fields appear in the `formdatas` structure with `form_id` and `form_ref_id`. The same structure is also used by synchronous contact writes. Use `GET /forms/{id}` to decode those IDs.

## Related guides

* See [Create and update contacts](/pages/v1/reference/contacts/contact-form-fields) for endpoint selection, upsert matching, and write payload examples.
* See [Handle form structure](/pages/v1/reference/forms/overview) for form types and `formdatas` decoding.