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:
{
"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.
Last modified on June 16, 2026
