Update contact by ID
curl --request PATCH \
--url https://incoming.qomon.app/contacts/{contactId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"data": {
"contact": {
"action_ids": [
1
],
"address": {
"addition": "<string>",
"building": "<string>",
"city": "<string>",
"country": "<string>",
"county": "<string>",
"door": "<string>",
"floor": "<string>",
"housenumber": "<string>",
"infos": "<string>",
"pollingstation": "<string>",
"postalcode": "<string>",
"state": "<string>",
"street": "<string>"
},
"age_category": 1,
"birth_city": "<string>",
"birth_country": "<string>",
"birth_dept": "<string>",
"birthdate": "2023-11-07T05:31:56Z",
"black_list": true,
"custom_fields": [
{
"data": "<string>",
"form_id": 1,
"form_ref_id": 1
}
],
"firstname": "<string>",
"formdatas": [
{
"data": "<string>",
"form_id": 1,
"form_ref_id": 1,
"date": "2023-11-07T05:31:56Z",
"survey_id": 1
}
],
"mail": "jsmith@example.com",
"married_name": "<string>",
"membership_code": "<string>",
"membership_number": 1,
"mobile": "<string>",
"mobile_invalid": true,
"nationality": "<string>",
"notes": [
{
"id": 1,
"contact_id": 1,
"created_at": "2023-11-07T05:31:56Z",
"data": "<string>",
"group_id": 1,
"only_super_admin": true,
"pinned": true,
"updated_at": "2023-11-07T05:31:56Z",
"user": {
"address": "<string>",
"avatar": "<string>",
"birthdate": "2023-11-07T05:31:56Z",
"city": "<string>",
"contacts": [
{
"id": 1
}
],
"firstname": "<string>",
"group_id": [
123
],
"locale": "<string>",
"location": "<string>",
"mail": "jsmith@example.com",
"phone": "<string>",
"postal": "<string>",
"role_data": {
"color": "<string>",
"id": 1,
"mobile": true,
"name": "<string>",
"order": 1,
"web": true
},
"status": "<string>",
"surname": "<string>",
"two_factor_enable": true
}
}
],
"phone": "<string>",
"phone_invalid": true,
"surname": "<string>",
"tags": [
{
"name": "<string>"
}
],
"user_contact_id": 123
}
}
}
'import requests
url = "https://incoming.qomon.app/contacts/{contactId}"
payload = { "data": { "contact": {
"action_ids": [1],
"address": {
"addition": "<string>",
"building": "<string>",
"city": "<string>",
"country": "<string>",
"county": "<string>",
"door": "<string>",
"floor": "<string>",
"housenumber": "<string>",
"infos": "<string>",
"pollingstation": "<string>",
"postalcode": "<string>",
"state": "<string>",
"street": "<string>"
},
"age_category": 1,
"birth_city": "<string>",
"birth_country": "<string>",
"birth_dept": "<string>",
"birthdate": "2023-11-07T05:31:56Z",
"black_list": True,
"custom_fields": [
{
"data": "<string>",
"form_id": 1,
"form_ref_id": 1
}
],
"firstname": "<string>",
"formdatas": [
{
"data": "<string>",
"form_id": 1,
"form_ref_id": 1,
"date": "2023-11-07T05:31:56Z",
"survey_id": 1
}
],
"mail": "jsmith@example.com",
"married_name": "<string>",
"membership_code": "<string>",
"membership_number": 1,
"mobile": "<string>",
"mobile_invalid": True,
"nationality": "<string>",
"notes": [
{
"id": 1,
"contact_id": 1,
"created_at": "2023-11-07T05:31:56Z",
"data": "<string>",
"group_id": 1,
"only_super_admin": True,
"pinned": True,
"updated_at": "2023-11-07T05:31:56Z",
"user": {
"address": "<string>",
"avatar": "<string>",
"birthdate": "2023-11-07T05:31:56Z",
"city": "<string>",
"contacts": [{ "id": 1 }],
"firstname": "<string>",
"group_id": [123],
"locale": "<string>",
"location": "<string>",
"mail": "jsmith@example.com",
"phone": "<string>",
"postal": "<string>",
"role_data": {
"color": "<string>",
"id": 1,
"mobile": True,
"name": "<string>",
"order": 1,
"web": True
},
"status": "<string>",
"surname": "<string>",
"two_factor_enable": True
}
}
],
"phone": "<string>",
"phone_invalid": True,
"surname": "<string>",
"tags": [{ "name": "<string>" }],
"user_contact_id": 123
} } }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
data: {
contact: {
action_ids: [1],
address: {
addition: '<string>',
building: '<string>',
city: '<string>',
country: '<string>',
county: '<string>',
door: '<string>',
floor: '<string>',
housenumber: '<string>',
infos: '<string>',
pollingstation: '<string>',
postalcode: '<string>',
state: '<string>',
street: '<string>'
},
age_category: 1,
birth_city: '<string>',
birth_country: '<string>',
birth_dept: '<string>',
birthdate: '2023-11-07T05:31:56Z',
black_list: true,
custom_fields: [{data: '<string>', form_id: 1, form_ref_id: 1}],
firstname: '<string>',
formdatas: [
{
data: '<string>',
form_id: 1,
form_ref_id: 1,
date: '2023-11-07T05:31:56Z',
survey_id: 1
}
],
mail: 'jsmith@example.com',
married_name: '<string>',
membership_code: '<string>',
membership_number: 1,
mobile: '<string>',
mobile_invalid: true,
nationality: '<string>',
notes: [
{
id: 1,
contact_id: 1,
created_at: '2023-11-07T05:31:56Z',
data: '<string>',
group_id: 1,
only_super_admin: true,
pinned: true,
updated_at: '2023-11-07T05:31:56Z',
user: {
address: '<string>',
avatar: '<string>',
birthdate: '2023-11-07T05:31:56Z',
city: '<string>',
contacts: [{id: 1}],
firstname: '<string>',
group_id: [123],
locale: '<string>',
location: '<string>',
mail: 'jsmith@example.com',
phone: '<string>',
postal: '<string>',
role_data: {color: '<string>', id: 1, mobile: true, name: '<string>', order: 1, web: true},
status: '<string>',
surname: '<string>',
two_factor_enable: true
}
}
],
phone: '<string>',
phone_invalid: true,
surname: '<string>',
tags: [{name: '<string>'}],
user_contact_id: 123
}
}
})
};
fetch('https://incoming.qomon.app/contacts/{contactId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://incoming.qomon.app/contacts/{contactId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'data' => [
'contact' => [
'action_ids' => [
1
],
'address' => [
'addition' => '<string>',
'building' => '<string>',
'city' => '<string>',
'country' => '<string>',
'county' => '<string>',
'door' => '<string>',
'floor' => '<string>',
'housenumber' => '<string>',
'infos' => '<string>',
'pollingstation' => '<string>',
'postalcode' => '<string>',
'state' => '<string>',
'street' => '<string>'
],
'age_category' => 1,
'birth_city' => '<string>',
'birth_country' => '<string>',
'birth_dept' => '<string>',
'birthdate' => '2023-11-07T05:31:56Z',
'black_list' => true,
'custom_fields' => [
[
'data' => '<string>',
'form_id' => 1,
'form_ref_id' => 1
]
],
'firstname' => '<string>',
'formdatas' => [
[
'data' => '<string>',
'form_id' => 1,
'form_ref_id' => 1,
'date' => '2023-11-07T05:31:56Z',
'survey_id' => 1
]
],
'mail' => 'jsmith@example.com',
'married_name' => '<string>',
'membership_code' => '<string>',
'membership_number' => 1,
'mobile' => '<string>',
'mobile_invalid' => true,
'nationality' => '<string>',
'notes' => [
[
'id' => 1,
'contact_id' => 1,
'created_at' => '2023-11-07T05:31:56Z',
'data' => '<string>',
'group_id' => 1,
'only_super_admin' => true,
'pinned' => true,
'updated_at' => '2023-11-07T05:31:56Z',
'user' => [
'address' => '<string>',
'avatar' => '<string>',
'birthdate' => '2023-11-07T05:31:56Z',
'city' => '<string>',
'contacts' => [
[
'id' => 1
]
],
'firstname' => '<string>',
'group_id' => [
123
],
'locale' => '<string>',
'location' => '<string>',
'mail' => 'jsmith@example.com',
'phone' => '<string>',
'postal' => '<string>',
'role_data' => [
'color' => '<string>',
'id' => 1,
'mobile' => true,
'name' => '<string>',
'order' => 1,
'web' => true
],
'status' => '<string>',
'surname' => '<string>',
'two_factor_enable' => true
]
]
],
'phone' => '<string>',
'phone_invalid' => true,
'surname' => '<string>',
'tags' => [
[
'name' => '<string>'
]
],
'user_contact_id' => 123
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://incoming.qomon.app/contacts/{contactId}"
payload := strings.NewReader("{\n \"data\": {\n \"contact\": {\n \"action_ids\": [\n 1\n ],\n \"address\": {\n \"addition\": \"<string>\",\n \"building\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"county\": \"<string>\",\n \"door\": \"<string>\",\n \"floor\": \"<string>\",\n \"housenumber\": \"<string>\",\n \"infos\": \"<string>\",\n \"pollingstation\": \"<string>\",\n \"postalcode\": \"<string>\",\n \"state\": \"<string>\",\n \"street\": \"<string>\"\n },\n \"age_category\": 1,\n \"birth_city\": \"<string>\",\n \"birth_country\": \"<string>\",\n \"birth_dept\": \"<string>\",\n \"birthdate\": \"2023-11-07T05:31:56Z\",\n \"black_list\": true,\n \"custom_fields\": [\n {\n \"data\": \"<string>\",\n \"form_id\": 1,\n \"form_ref_id\": 1\n }\n ],\n \"firstname\": \"<string>\",\n \"formdatas\": [\n {\n \"data\": \"<string>\",\n \"form_id\": 1,\n \"form_ref_id\": 1,\n \"date\": \"2023-11-07T05:31:56Z\",\n \"survey_id\": 1\n }\n ],\n \"mail\": \"jsmith@example.com\",\n \"married_name\": \"<string>\",\n \"membership_code\": \"<string>\",\n \"membership_number\": 1,\n \"mobile\": \"<string>\",\n \"mobile_invalid\": true,\n \"nationality\": \"<string>\",\n \"notes\": [\n {\n \"id\": 1,\n \"contact_id\": 1,\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"data\": \"<string>\",\n \"group_id\": 1,\n \"only_super_admin\": true,\n \"pinned\": true,\n \"updated_at\": \"2023-11-07T05:31:56Z\",\n \"user\": {\n \"address\": \"<string>\",\n \"avatar\": \"<string>\",\n \"birthdate\": \"2023-11-07T05:31:56Z\",\n \"city\": \"<string>\",\n \"contacts\": [\n {\n \"id\": 1\n }\n ],\n \"firstname\": \"<string>\",\n \"group_id\": [\n 123\n ],\n \"locale\": \"<string>\",\n \"location\": \"<string>\",\n \"mail\": \"jsmith@example.com\",\n \"phone\": \"<string>\",\n \"postal\": \"<string>\",\n \"role_data\": {\n \"color\": \"<string>\",\n \"id\": 1,\n \"mobile\": true,\n \"name\": \"<string>\",\n \"order\": 1,\n \"web\": true\n },\n \"status\": \"<string>\",\n \"surname\": \"<string>\",\n \"two_factor_enable\": true\n }\n }\n ],\n \"phone\": \"<string>\",\n \"phone_invalid\": true,\n \"surname\": \"<string>\",\n \"tags\": [\n {\n \"name\": \"<string>\"\n }\n ],\n \"user_contact_id\": 123\n }\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://incoming.qomon.app/contacts/{contactId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"data\": {\n \"contact\": {\n \"action_ids\": [\n 1\n ],\n \"address\": {\n \"addition\": \"<string>\",\n \"building\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"county\": \"<string>\",\n \"door\": \"<string>\",\n \"floor\": \"<string>\",\n \"housenumber\": \"<string>\",\n \"infos\": \"<string>\",\n \"pollingstation\": \"<string>\",\n \"postalcode\": \"<string>\",\n \"state\": \"<string>\",\n \"street\": \"<string>\"\n },\n \"age_category\": 1,\n \"birth_city\": \"<string>\",\n \"birth_country\": \"<string>\",\n \"birth_dept\": \"<string>\",\n \"birthdate\": \"2023-11-07T05:31:56Z\",\n \"black_list\": true,\n \"custom_fields\": [\n {\n \"data\": \"<string>\",\n \"form_id\": 1,\n \"form_ref_id\": 1\n }\n ],\n \"firstname\": \"<string>\",\n \"formdatas\": [\n {\n \"data\": \"<string>\",\n \"form_id\": 1,\n \"form_ref_id\": 1,\n \"date\": \"2023-11-07T05:31:56Z\",\n \"survey_id\": 1\n }\n ],\n \"mail\": \"jsmith@example.com\",\n \"married_name\": \"<string>\",\n \"membership_code\": \"<string>\",\n \"membership_number\": 1,\n \"mobile\": \"<string>\",\n \"mobile_invalid\": true,\n \"nationality\": \"<string>\",\n \"notes\": [\n {\n \"id\": 1,\n \"contact_id\": 1,\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"data\": \"<string>\",\n \"group_id\": 1,\n \"only_super_admin\": true,\n \"pinned\": true,\n \"updated_at\": \"2023-11-07T05:31:56Z\",\n \"user\": {\n \"address\": \"<string>\",\n \"avatar\": \"<string>\",\n \"birthdate\": \"2023-11-07T05:31:56Z\",\n \"city\": \"<string>\",\n \"contacts\": [\n {\n \"id\": 1\n }\n ],\n \"firstname\": \"<string>\",\n \"group_id\": [\n 123\n ],\n \"locale\": \"<string>\",\n \"location\": \"<string>\",\n \"mail\": \"jsmith@example.com\",\n \"phone\": \"<string>\",\n \"postal\": \"<string>\",\n \"role_data\": {\n \"color\": \"<string>\",\n \"id\": 1,\n \"mobile\": true,\n \"name\": \"<string>\",\n \"order\": 1,\n \"web\": true\n },\n \"status\": \"<string>\",\n \"surname\": \"<string>\",\n \"two_factor_enable\": true\n }\n }\n ],\n \"phone\": \"<string>\",\n \"phone_invalid\": true,\n \"surname\": \"<string>\",\n \"tags\": [\n {\n \"name\": \"<string>\"\n }\n ],\n \"user_contact_id\": 123\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://incoming.qomon.app/contacts/{contactId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"data\": {\n \"contact\": {\n \"action_ids\": [\n 1\n ],\n \"address\": {\n \"addition\": \"<string>\",\n \"building\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"county\": \"<string>\",\n \"door\": \"<string>\",\n \"floor\": \"<string>\",\n \"housenumber\": \"<string>\",\n \"infos\": \"<string>\",\n \"pollingstation\": \"<string>\",\n \"postalcode\": \"<string>\",\n \"state\": \"<string>\",\n \"street\": \"<string>\"\n },\n \"age_category\": 1,\n \"birth_city\": \"<string>\",\n \"birth_country\": \"<string>\",\n \"birth_dept\": \"<string>\",\n \"birthdate\": \"2023-11-07T05:31:56Z\",\n \"black_list\": true,\n \"custom_fields\": [\n {\n \"data\": \"<string>\",\n \"form_id\": 1,\n \"form_ref_id\": 1\n }\n ],\n \"firstname\": \"<string>\",\n \"formdatas\": [\n {\n \"data\": \"<string>\",\n \"form_id\": 1,\n \"form_ref_id\": 1,\n \"date\": \"2023-11-07T05:31:56Z\",\n \"survey_id\": 1\n }\n ],\n \"mail\": \"jsmith@example.com\",\n \"married_name\": \"<string>\",\n \"membership_code\": \"<string>\",\n \"membership_number\": 1,\n \"mobile\": \"<string>\",\n \"mobile_invalid\": true,\n \"nationality\": \"<string>\",\n \"notes\": [\n {\n \"id\": 1,\n \"contact_id\": 1,\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"data\": \"<string>\",\n \"group_id\": 1,\n \"only_super_admin\": true,\n \"pinned\": true,\n \"updated_at\": \"2023-11-07T05:31:56Z\",\n \"user\": {\n \"address\": \"<string>\",\n \"avatar\": \"<string>\",\n \"birthdate\": \"2023-11-07T05:31:56Z\",\n \"city\": \"<string>\",\n \"contacts\": [\n {\n \"id\": 1\n }\n ],\n \"firstname\": \"<string>\",\n \"group_id\": [\n 123\n ],\n \"locale\": \"<string>\",\n \"location\": \"<string>\",\n \"mail\": \"jsmith@example.com\",\n \"phone\": \"<string>\",\n \"postal\": \"<string>\",\n \"role_data\": {\n \"color\": \"<string>\",\n \"id\": 1,\n \"mobile\": true,\n \"name\": \"<string>\",\n \"order\": 1,\n \"web\": true\n },\n \"status\": \"<string>\",\n \"surname\": \"<string>\",\n \"two_factor_enable\": true\n }\n }\n ],\n \"phone\": \"<string>\",\n \"phone_invalid\": true,\n \"surname\": \"<string>\",\n \"tags\": [\n {\n \"name\": \"<string>\"\n }\n ],\n \"user_contact_id\": 123\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"data": {
"contact": {
"id": 1,
"CreatedAt": "2023-11-07T05:31:56Z",
"UpdatedAt": "2023-11-07T05:31:56Z",
"action_ids": [
1
],
"address": {
"addition": "<string>",
"building": "<string>",
"city": "<string>",
"country": "<string>",
"county": "<string>",
"door": "<string>",
"floor": "<string>",
"housenumber": "<string>",
"id": 1,
"infos": "<string>",
"latitude": "<string>",
"location": "<string>",
"longitude": "<string>",
"pollingstation": "<string>",
"postalcode": "<string>",
"score": 123,
"state": "<string>",
"street": "<string>"
},
"age_category": 1,
"birth_city": "<string>",
"birth_country": "<string>",
"birth_dept": "<string>",
"birthdate": "2023-11-07T05:31:56Z",
"black_list": true,
"custom_fields": [
{
"data": "<string>",
"form_id": 1,
"form_ref_id": 1,
"id": 1
}
],
"firstname": "<string>",
"formdatas": [
{
"data": "<string>",
"form_id": 1,
"form_ref_id": 1,
"id": 1,
"contact_id": 1,
"date": "2023-11-07T05:31:56Z",
"group_id": 1,
"survey_id": 1
}
],
"group_id": 1,
"lastchange": "2023-11-07T05:31:56Z",
"lastchangeuserid": 1,
"mail": "jsmith@example.com",
"married_name": "<string>",
"membership_code": "<string>",
"membership_number": 1,
"mobile": "<string>",
"mobile_invalid": true,
"nationality": "<string>",
"notes": [
{
"id": 1,
"contact_id": 1,
"created_at": "2023-11-07T05:31:56Z",
"data": "<string>",
"group_id": 1,
"only_super_admin": true,
"pinned": true,
"updated_at": "2023-11-07T05:31:56Z",
"user": {
"CreatedAt": "2023-11-07T05:31:56Z",
"UpdatedAt": "2023-11-07T05:31:56Z",
"address": "<string>",
"avatar": "<string>",
"birthdate": "2023-11-07T05:31:56Z",
"city": "<string>",
"contacts": [
{
"id": 1
}
],
"created": "2023-11-07T05:31:56Z",
"firstname": "<string>",
"group_id": [
123
],
"id": 123,
"locale": "<string>",
"location": "<string>",
"mail": "jsmith@example.com",
"phone": "<string>",
"postal": "<string>",
"role_data": {
"color": "<string>",
"id": 1,
"mobile": true,
"name": "<string>",
"order": 1,
"web": true
},
"status": "<string>",
"surname": "<string>",
"two_factor_enable": true
}
}
],
"phone": "<string>",
"phone_invalid": true,
"surname": "<string>",
"tags": [
{
"name": "<string>"
}
],
"user_contact_id": 123
}
},
"status": "<string>"
}{
"detail": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "about:blank"
}Contacts
Update contact by ID
Fully replace an existing contact in the Qomon database (behaves like PUT).
PATCH
/
contacts
/
{contactId}
Update contact by ID
curl --request PATCH \
--url https://incoming.qomon.app/contacts/{contactId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"data": {
"contact": {
"action_ids": [
1
],
"address": {
"addition": "<string>",
"building": "<string>",
"city": "<string>",
"country": "<string>",
"county": "<string>",
"door": "<string>",
"floor": "<string>",
"housenumber": "<string>",
"infos": "<string>",
"pollingstation": "<string>",
"postalcode": "<string>",
"state": "<string>",
"street": "<string>"
},
"age_category": 1,
"birth_city": "<string>",
"birth_country": "<string>",
"birth_dept": "<string>",
"birthdate": "2023-11-07T05:31:56Z",
"black_list": true,
"custom_fields": [
{
"data": "<string>",
"form_id": 1,
"form_ref_id": 1
}
],
"firstname": "<string>",
"formdatas": [
{
"data": "<string>",
"form_id": 1,
"form_ref_id": 1,
"date": "2023-11-07T05:31:56Z",
"survey_id": 1
}
],
"mail": "jsmith@example.com",
"married_name": "<string>",
"membership_code": "<string>",
"membership_number": 1,
"mobile": "<string>",
"mobile_invalid": true,
"nationality": "<string>",
"notes": [
{
"id": 1,
"contact_id": 1,
"created_at": "2023-11-07T05:31:56Z",
"data": "<string>",
"group_id": 1,
"only_super_admin": true,
"pinned": true,
"updated_at": "2023-11-07T05:31:56Z",
"user": {
"address": "<string>",
"avatar": "<string>",
"birthdate": "2023-11-07T05:31:56Z",
"city": "<string>",
"contacts": [
{
"id": 1
}
],
"firstname": "<string>",
"group_id": [
123
],
"locale": "<string>",
"location": "<string>",
"mail": "jsmith@example.com",
"phone": "<string>",
"postal": "<string>",
"role_data": {
"color": "<string>",
"id": 1,
"mobile": true,
"name": "<string>",
"order": 1,
"web": true
},
"status": "<string>",
"surname": "<string>",
"two_factor_enable": true
}
}
],
"phone": "<string>",
"phone_invalid": true,
"surname": "<string>",
"tags": [
{
"name": "<string>"
}
],
"user_contact_id": 123
}
}
}
'import requests
url = "https://incoming.qomon.app/contacts/{contactId}"
payload = { "data": { "contact": {
"action_ids": [1],
"address": {
"addition": "<string>",
"building": "<string>",
"city": "<string>",
"country": "<string>",
"county": "<string>",
"door": "<string>",
"floor": "<string>",
"housenumber": "<string>",
"infos": "<string>",
"pollingstation": "<string>",
"postalcode": "<string>",
"state": "<string>",
"street": "<string>"
},
"age_category": 1,
"birth_city": "<string>",
"birth_country": "<string>",
"birth_dept": "<string>",
"birthdate": "2023-11-07T05:31:56Z",
"black_list": True,
"custom_fields": [
{
"data": "<string>",
"form_id": 1,
"form_ref_id": 1
}
],
"firstname": "<string>",
"formdatas": [
{
"data": "<string>",
"form_id": 1,
"form_ref_id": 1,
"date": "2023-11-07T05:31:56Z",
"survey_id": 1
}
],
"mail": "jsmith@example.com",
"married_name": "<string>",
"membership_code": "<string>",
"membership_number": 1,
"mobile": "<string>",
"mobile_invalid": True,
"nationality": "<string>",
"notes": [
{
"id": 1,
"contact_id": 1,
"created_at": "2023-11-07T05:31:56Z",
"data": "<string>",
"group_id": 1,
"only_super_admin": True,
"pinned": True,
"updated_at": "2023-11-07T05:31:56Z",
"user": {
"address": "<string>",
"avatar": "<string>",
"birthdate": "2023-11-07T05:31:56Z",
"city": "<string>",
"contacts": [{ "id": 1 }],
"firstname": "<string>",
"group_id": [123],
"locale": "<string>",
"location": "<string>",
"mail": "jsmith@example.com",
"phone": "<string>",
"postal": "<string>",
"role_data": {
"color": "<string>",
"id": 1,
"mobile": True,
"name": "<string>",
"order": 1,
"web": True
},
"status": "<string>",
"surname": "<string>",
"two_factor_enable": True
}
}
],
"phone": "<string>",
"phone_invalid": True,
"surname": "<string>",
"tags": [{ "name": "<string>" }],
"user_contact_id": 123
} } }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
data: {
contact: {
action_ids: [1],
address: {
addition: '<string>',
building: '<string>',
city: '<string>',
country: '<string>',
county: '<string>',
door: '<string>',
floor: '<string>',
housenumber: '<string>',
infos: '<string>',
pollingstation: '<string>',
postalcode: '<string>',
state: '<string>',
street: '<string>'
},
age_category: 1,
birth_city: '<string>',
birth_country: '<string>',
birth_dept: '<string>',
birthdate: '2023-11-07T05:31:56Z',
black_list: true,
custom_fields: [{data: '<string>', form_id: 1, form_ref_id: 1}],
firstname: '<string>',
formdatas: [
{
data: '<string>',
form_id: 1,
form_ref_id: 1,
date: '2023-11-07T05:31:56Z',
survey_id: 1
}
],
mail: 'jsmith@example.com',
married_name: '<string>',
membership_code: '<string>',
membership_number: 1,
mobile: '<string>',
mobile_invalid: true,
nationality: '<string>',
notes: [
{
id: 1,
contact_id: 1,
created_at: '2023-11-07T05:31:56Z',
data: '<string>',
group_id: 1,
only_super_admin: true,
pinned: true,
updated_at: '2023-11-07T05:31:56Z',
user: {
address: '<string>',
avatar: '<string>',
birthdate: '2023-11-07T05:31:56Z',
city: '<string>',
contacts: [{id: 1}],
firstname: '<string>',
group_id: [123],
locale: '<string>',
location: '<string>',
mail: 'jsmith@example.com',
phone: '<string>',
postal: '<string>',
role_data: {color: '<string>', id: 1, mobile: true, name: '<string>', order: 1, web: true},
status: '<string>',
surname: '<string>',
two_factor_enable: true
}
}
],
phone: '<string>',
phone_invalid: true,
surname: '<string>',
tags: [{name: '<string>'}],
user_contact_id: 123
}
}
})
};
fetch('https://incoming.qomon.app/contacts/{contactId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://incoming.qomon.app/contacts/{contactId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'data' => [
'contact' => [
'action_ids' => [
1
],
'address' => [
'addition' => '<string>',
'building' => '<string>',
'city' => '<string>',
'country' => '<string>',
'county' => '<string>',
'door' => '<string>',
'floor' => '<string>',
'housenumber' => '<string>',
'infos' => '<string>',
'pollingstation' => '<string>',
'postalcode' => '<string>',
'state' => '<string>',
'street' => '<string>'
],
'age_category' => 1,
'birth_city' => '<string>',
'birth_country' => '<string>',
'birth_dept' => '<string>',
'birthdate' => '2023-11-07T05:31:56Z',
'black_list' => true,
'custom_fields' => [
[
'data' => '<string>',
'form_id' => 1,
'form_ref_id' => 1
]
],
'firstname' => '<string>',
'formdatas' => [
[
'data' => '<string>',
'form_id' => 1,
'form_ref_id' => 1,
'date' => '2023-11-07T05:31:56Z',
'survey_id' => 1
]
],
'mail' => 'jsmith@example.com',
'married_name' => '<string>',
'membership_code' => '<string>',
'membership_number' => 1,
'mobile' => '<string>',
'mobile_invalid' => true,
'nationality' => '<string>',
'notes' => [
[
'id' => 1,
'contact_id' => 1,
'created_at' => '2023-11-07T05:31:56Z',
'data' => '<string>',
'group_id' => 1,
'only_super_admin' => true,
'pinned' => true,
'updated_at' => '2023-11-07T05:31:56Z',
'user' => [
'address' => '<string>',
'avatar' => '<string>',
'birthdate' => '2023-11-07T05:31:56Z',
'city' => '<string>',
'contacts' => [
[
'id' => 1
]
],
'firstname' => '<string>',
'group_id' => [
123
],
'locale' => '<string>',
'location' => '<string>',
'mail' => 'jsmith@example.com',
'phone' => '<string>',
'postal' => '<string>',
'role_data' => [
'color' => '<string>',
'id' => 1,
'mobile' => true,
'name' => '<string>',
'order' => 1,
'web' => true
],
'status' => '<string>',
'surname' => '<string>',
'two_factor_enable' => true
]
]
],
'phone' => '<string>',
'phone_invalid' => true,
'surname' => '<string>',
'tags' => [
[
'name' => '<string>'
]
],
'user_contact_id' => 123
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://incoming.qomon.app/contacts/{contactId}"
payload := strings.NewReader("{\n \"data\": {\n \"contact\": {\n \"action_ids\": [\n 1\n ],\n \"address\": {\n \"addition\": \"<string>\",\n \"building\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"county\": \"<string>\",\n \"door\": \"<string>\",\n \"floor\": \"<string>\",\n \"housenumber\": \"<string>\",\n \"infos\": \"<string>\",\n \"pollingstation\": \"<string>\",\n \"postalcode\": \"<string>\",\n \"state\": \"<string>\",\n \"street\": \"<string>\"\n },\n \"age_category\": 1,\n \"birth_city\": \"<string>\",\n \"birth_country\": \"<string>\",\n \"birth_dept\": \"<string>\",\n \"birthdate\": \"2023-11-07T05:31:56Z\",\n \"black_list\": true,\n \"custom_fields\": [\n {\n \"data\": \"<string>\",\n \"form_id\": 1,\n \"form_ref_id\": 1\n }\n ],\n \"firstname\": \"<string>\",\n \"formdatas\": [\n {\n \"data\": \"<string>\",\n \"form_id\": 1,\n \"form_ref_id\": 1,\n \"date\": \"2023-11-07T05:31:56Z\",\n \"survey_id\": 1\n }\n ],\n \"mail\": \"jsmith@example.com\",\n \"married_name\": \"<string>\",\n \"membership_code\": \"<string>\",\n \"membership_number\": 1,\n \"mobile\": \"<string>\",\n \"mobile_invalid\": true,\n \"nationality\": \"<string>\",\n \"notes\": [\n {\n \"id\": 1,\n \"contact_id\": 1,\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"data\": \"<string>\",\n \"group_id\": 1,\n \"only_super_admin\": true,\n \"pinned\": true,\n \"updated_at\": \"2023-11-07T05:31:56Z\",\n \"user\": {\n \"address\": \"<string>\",\n \"avatar\": \"<string>\",\n \"birthdate\": \"2023-11-07T05:31:56Z\",\n \"city\": \"<string>\",\n \"contacts\": [\n {\n \"id\": 1\n }\n ],\n \"firstname\": \"<string>\",\n \"group_id\": [\n 123\n ],\n \"locale\": \"<string>\",\n \"location\": \"<string>\",\n \"mail\": \"jsmith@example.com\",\n \"phone\": \"<string>\",\n \"postal\": \"<string>\",\n \"role_data\": {\n \"color\": \"<string>\",\n \"id\": 1,\n \"mobile\": true,\n \"name\": \"<string>\",\n \"order\": 1,\n \"web\": true\n },\n \"status\": \"<string>\",\n \"surname\": \"<string>\",\n \"two_factor_enable\": true\n }\n }\n ],\n \"phone\": \"<string>\",\n \"phone_invalid\": true,\n \"surname\": \"<string>\",\n \"tags\": [\n {\n \"name\": \"<string>\"\n }\n ],\n \"user_contact_id\": 123\n }\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://incoming.qomon.app/contacts/{contactId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"data\": {\n \"contact\": {\n \"action_ids\": [\n 1\n ],\n \"address\": {\n \"addition\": \"<string>\",\n \"building\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"county\": \"<string>\",\n \"door\": \"<string>\",\n \"floor\": \"<string>\",\n \"housenumber\": \"<string>\",\n \"infos\": \"<string>\",\n \"pollingstation\": \"<string>\",\n \"postalcode\": \"<string>\",\n \"state\": \"<string>\",\n \"street\": \"<string>\"\n },\n \"age_category\": 1,\n \"birth_city\": \"<string>\",\n \"birth_country\": \"<string>\",\n \"birth_dept\": \"<string>\",\n \"birthdate\": \"2023-11-07T05:31:56Z\",\n \"black_list\": true,\n \"custom_fields\": [\n {\n \"data\": \"<string>\",\n \"form_id\": 1,\n \"form_ref_id\": 1\n }\n ],\n \"firstname\": \"<string>\",\n \"formdatas\": [\n {\n \"data\": \"<string>\",\n \"form_id\": 1,\n \"form_ref_id\": 1,\n \"date\": \"2023-11-07T05:31:56Z\",\n \"survey_id\": 1\n }\n ],\n \"mail\": \"jsmith@example.com\",\n \"married_name\": \"<string>\",\n \"membership_code\": \"<string>\",\n \"membership_number\": 1,\n \"mobile\": \"<string>\",\n \"mobile_invalid\": true,\n \"nationality\": \"<string>\",\n \"notes\": [\n {\n \"id\": 1,\n \"contact_id\": 1,\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"data\": \"<string>\",\n \"group_id\": 1,\n \"only_super_admin\": true,\n \"pinned\": true,\n \"updated_at\": \"2023-11-07T05:31:56Z\",\n \"user\": {\n \"address\": \"<string>\",\n \"avatar\": \"<string>\",\n \"birthdate\": \"2023-11-07T05:31:56Z\",\n \"city\": \"<string>\",\n \"contacts\": [\n {\n \"id\": 1\n }\n ],\n \"firstname\": \"<string>\",\n \"group_id\": [\n 123\n ],\n \"locale\": \"<string>\",\n \"location\": \"<string>\",\n \"mail\": \"jsmith@example.com\",\n \"phone\": \"<string>\",\n \"postal\": \"<string>\",\n \"role_data\": {\n \"color\": \"<string>\",\n \"id\": 1,\n \"mobile\": true,\n \"name\": \"<string>\",\n \"order\": 1,\n \"web\": true\n },\n \"status\": \"<string>\",\n \"surname\": \"<string>\",\n \"two_factor_enable\": true\n }\n }\n ],\n \"phone\": \"<string>\",\n \"phone_invalid\": true,\n \"surname\": \"<string>\",\n \"tags\": [\n {\n \"name\": \"<string>\"\n }\n ],\n \"user_contact_id\": 123\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://incoming.qomon.app/contacts/{contactId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"data\": {\n \"contact\": {\n \"action_ids\": [\n 1\n ],\n \"address\": {\n \"addition\": \"<string>\",\n \"building\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"county\": \"<string>\",\n \"door\": \"<string>\",\n \"floor\": \"<string>\",\n \"housenumber\": \"<string>\",\n \"infos\": \"<string>\",\n \"pollingstation\": \"<string>\",\n \"postalcode\": \"<string>\",\n \"state\": \"<string>\",\n \"street\": \"<string>\"\n },\n \"age_category\": 1,\n \"birth_city\": \"<string>\",\n \"birth_country\": \"<string>\",\n \"birth_dept\": \"<string>\",\n \"birthdate\": \"2023-11-07T05:31:56Z\",\n \"black_list\": true,\n \"custom_fields\": [\n {\n \"data\": \"<string>\",\n \"form_id\": 1,\n \"form_ref_id\": 1\n }\n ],\n \"firstname\": \"<string>\",\n \"formdatas\": [\n {\n \"data\": \"<string>\",\n \"form_id\": 1,\n \"form_ref_id\": 1,\n \"date\": \"2023-11-07T05:31:56Z\",\n \"survey_id\": 1\n }\n ],\n \"mail\": \"jsmith@example.com\",\n \"married_name\": \"<string>\",\n \"membership_code\": \"<string>\",\n \"membership_number\": 1,\n \"mobile\": \"<string>\",\n \"mobile_invalid\": true,\n \"nationality\": \"<string>\",\n \"notes\": [\n {\n \"id\": 1,\n \"contact_id\": 1,\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"data\": \"<string>\",\n \"group_id\": 1,\n \"only_super_admin\": true,\n \"pinned\": true,\n \"updated_at\": \"2023-11-07T05:31:56Z\",\n \"user\": {\n \"address\": \"<string>\",\n \"avatar\": \"<string>\",\n \"birthdate\": \"2023-11-07T05:31:56Z\",\n \"city\": \"<string>\",\n \"contacts\": [\n {\n \"id\": 1\n }\n ],\n \"firstname\": \"<string>\",\n \"group_id\": [\n 123\n ],\n \"locale\": \"<string>\",\n \"location\": \"<string>\",\n \"mail\": \"jsmith@example.com\",\n \"phone\": \"<string>\",\n \"postal\": \"<string>\",\n \"role_data\": {\n \"color\": \"<string>\",\n \"id\": 1,\n \"mobile\": true,\n \"name\": \"<string>\",\n \"order\": 1,\n \"web\": true\n },\n \"status\": \"<string>\",\n \"surname\": \"<string>\",\n \"two_factor_enable\": true\n }\n }\n ],\n \"phone\": \"<string>\",\n \"phone_invalid\": true,\n \"surname\": \"<string>\",\n \"tags\": [\n {\n \"name\": \"<string>\"\n }\n ],\n \"user_contact_id\": 123\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"data": {
"contact": {
"id": 1,
"CreatedAt": "2023-11-07T05:31:56Z",
"UpdatedAt": "2023-11-07T05:31:56Z",
"action_ids": [
1
],
"address": {
"addition": "<string>",
"building": "<string>",
"city": "<string>",
"country": "<string>",
"county": "<string>",
"door": "<string>",
"floor": "<string>",
"housenumber": "<string>",
"id": 1,
"infos": "<string>",
"latitude": "<string>",
"location": "<string>",
"longitude": "<string>",
"pollingstation": "<string>",
"postalcode": "<string>",
"score": 123,
"state": "<string>",
"street": "<string>"
},
"age_category": 1,
"birth_city": "<string>",
"birth_country": "<string>",
"birth_dept": "<string>",
"birthdate": "2023-11-07T05:31:56Z",
"black_list": true,
"custom_fields": [
{
"data": "<string>",
"form_id": 1,
"form_ref_id": 1,
"id": 1
}
],
"firstname": "<string>",
"formdatas": [
{
"data": "<string>",
"form_id": 1,
"form_ref_id": 1,
"id": 1,
"contact_id": 1,
"date": "2023-11-07T05:31:56Z",
"group_id": 1,
"survey_id": 1
}
],
"group_id": 1,
"lastchange": "2023-11-07T05:31:56Z",
"lastchangeuserid": 1,
"mail": "jsmith@example.com",
"married_name": "<string>",
"membership_code": "<string>",
"membership_number": 1,
"mobile": "<string>",
"mobile_invalid": true,
"nationality": "<string>",
"notes": [
{
"id": 1,
"contact_id": 1,
"created_at": "2023-11-07T05:31:56Z",
"data": "<string>",
"group_id": 1,
"only_super_admin": true,
"pinned": true,
"updated_at": "2023-11-07T05:31:56Z",
"user": {
"CreatedAt": "2023-11-07T05:31:56Z",
"UpdatedAt": "2023-11-07T05:31:56Z",
"address": "<string>",
"avatar": "<string>",
"birthdate": "2023-11-07T05:31:56Z",
"city": "<string>",
"contacts": [
{
"id": 1
}
],
"created": "2023-11-07T05:31:56Z",
"firstname": "<string>",
"group_id": [
123
],
"id": 123,
"locale": "<string>",
"location": "<string>",
"mail": "jsmith@example.com",
"phone": "<string>",
"postal": "<string>",
"role_data": {
"color": "<string>",
"id": 1,
"mobile": true,
"name": "<string>",
"order": 1,
"web": true
},
"status": "<string>",
"surname": "<string>",
"two_factor_enable": true
}
}
],
"phone": "<string>",
"phone_invalid": true,
"surname": "<string>",
"tags": [
{
"name": "<string>"
}
],
"user_contact_id": 123
}
},
"status": "<string>"
}{
"detail": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "about:blank"
}This endpoint uses the PATCH verb but behaves like a PUT (full replacement). Any fields that are NOT included in the payload will be cleared/removed. Always send the full contact object if you don’t want to lose existing data.
To synchronize and mass update your contacts with Qomon database, use
POST /contacts/upsert instead. This synchronous endpoint costs 5 rate-limit tokens per request.formdatas structure with form_id and form_ref_id.
form_id: the ID of the advanced fieldform_ref_id: the ID of the value of the advanced fielddata: free text if the field (“forms”) type is Text, Integer, or Date (input format:YYYY-MM-DD'T'HH:mm:ss.SSS'Z'; responses may return up to microsecond precision:YYYY-MM-DD'T'HH:mm:ss.SSSSSS'Z'); otherwise, use the value of the refvaluedate: the date of the formdata entry
"formdatas": [
{
"form_id": 47566,
"form_ref_id": 15648,
"data": "consent_email"
}
]
custom_fields structure with form_id and form_ref_id.
form_id: the ID of the custom fieldform_ref_id: the ID of the value of the custom fielddata: free text if the field (“forms”) type is Text, Integer, or Date (input format:YYYY-MM-DD'T'HH:mm:ss.SSS'Z'; responses may return up to microsecond precision:YYYY-MM-DD'T'HH:mm:ss.SSSSSS'Z'); otherwise, use the value of the refvaluedate: the date of the custom_field entry
"custom_fields": [
{
"form_id": 879854,
"form_ref_id": 98741,
"data": "hamburger",
"date": "2024-07-17T11:34:42.195Z"
}
]
- Each patch will generate new ids for formdatas and custom_fields. (due to the full replace behavior: soft delete + recreate)
- If you don’t send the exhaustive list of formdatas or custom_fields, the missing ones will be deleted (soft).
- For Text, Integer and Date Fields, if you add a formdata or custom_field, it will be added to the existing ones.
- For Radio (single select), if you add a formdata or custom_field, it will replace the existing ones.
- For Checkbox (multi-select) fields, any new value will be added to the existing ones.
- If you change a formdata or custom_field, it will update it. (the id is not required here because of the full-replace behavior).
Authorizations
OAuth2 access token. Pass the token in the Authorization header as Bearer <token>. The token is looked up in Redis to resolve the caller identity.
Path Parameters
Contact ID.
Required range:
x >= 0Example:
42
Body
application/json
Show child attributes
Show child attributes
Last modified on July 7, 2026
Was this page helpful?
⌘I