{"id":755,"date":"2025-08-11T14:31:29","date_gmt":"2025-08-11T14:31:29","guid":{"rendered":"https:\/\/rs.quarticon.com\/qon-api-contact-synchronisation-en\/"},"modified":"2025-08-12T15:38:16","modified_gmt":"2025-08-12T15:38:16","slug":"qon-api-contact-synchronisation-en","status":"publish","type":"post","link":"https:\/\/help.quarticon.com\/pl\/qon-api-contact-synchronisation-en\/","title":{"rendered":"QON API contact synchronisation (EN)"},"content":{"rendered":"
\n
\n

Authentication<\/b><\/p>\n<\/div>\n

\n<\/div>\n
\n

All requests to the API are authenticated by providing your API key. The API key should be provided as an HTTP header named Api-Token.<\/p>\n<\/div>\n

\n<\/div>\n
\n
Header
curl -H 'Api-Token: YOUR_TOKEN' https:\/\/account.api-us1.com\/api\/3\/<\/pre>\n<\/div>\n
\n<\/div>\n
\n
Your API key can be found in your account on the Settings <\/b>page under the Developer <\/b>tab. Each user in your Quarticon CDXP account has their own unique API key.<\/p>\n<\/div>\n
\n\n\n\n
\n
\n
Remember to keep your API key secret. Do not share it and take care not to expose it publicly in client-side code.<\/h3>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
\n
Base URL<\/b><\/p>\n<\/div>\n
\n<\/div>\n
\n
The API is accessed using a base URL that is specific to your account. In the examples provided in this documentation, we use the URL youraccountname.api-us1.com as a stand-in for your real account API URL. Your API URL can be found in your account on the My Settings<\/b> page under the Developer <\/b>tab. In addition, URL paths should begin with \/api\/3<\/i> to specify version 3 of the API. Generally, the URL will be in the form:<\/p>\n<\/div>\n
\n<\/div>\n
\n
https:\/\/{account}.api-us1.com\/api\/3\/{endpoint}<\/i><\/p>\n<\/div>\n
\n<\/div>\n
\n
You have to log in into your account on Quarticon CDXP, go to the page Settings<\/b> \u2192 Developer <\/b>and insert data appropriately:<\/p>\n<\/div>\n
\n<\/div>\n
<\/a><\/div>\n
\n
All API calls should be made over HTTPS.<\/p>\n<\/div>\n
\n<\/div>\n
\n
Rate Limits<\/b><\/p>\n<\/div>\n
\n<\/div>\n
\n
Our API has a rate limit of 5 requests per second per account.<\/p>\n<\/div>\n
\n<\/div>\n
\n
Property<\/b><\/h3>\n<\/div>\n
\n
The data type of the value stored in the field. Valid types are currency, date, datetime, number, text, and textarea.<\/p>\n<\/div>\n
\n\n\n\n\n\n\n\n\n\n\n\n
\n
\n
Type Name<\/b><\/p>\n<\/div>\n<\/td>\n
\n
\n
Description<\/b><\/p>\n<\/div>\n<\/td>\n
\n
\n
Notes<\/b><\/p>\n<\/div>\n<\/td>\n<\/tr>\n
\n
\n
text<\/p>\n<\/div>\n<\/td>\n
\n
\n
A short text field<\/p>\n<\/div>\n<\/td>\n
\n
\n
Limited to 65,535. Longer strings will not be saved.<\/p>\n<\/div>\n<\/td>\n<\/tr>\n
\n
\n
textarea<\/p>\n<\/div>\n<\/td>\n
\n
\n
A text field of any length<\/p>\n<\/div>\n<\/td>\n
\n
\n<\/div>\n<\/td>\n<\/tr>\n
\n
\n
number<\/p>\n<\/div>\n<\/td>\n
\n
\n
An integer or decimal number<\/p>\n<\/div>\n<\/td>\n
\n
\n
Number of decimals saved can be defined with the additional scale field. Scale can be set to 0 to denote integer values \u2013 this is the default.<\/p>\n<\/div>\n<\/td>\n<\/tr>\n
\n
\n
datetime<\/p>\n<\/div>\n<\/td>\n
\n
\n
A valid ISO8601<\/a> date time string (e.g. 2021-08-13T17:51:44+00:00)<\/p>\n<\/div>\n<\/td>\n
\n
\n<\/div>\n<\/td>\n<\/tr>\n
\n
\n
date<\/p>\n<\/div>\n<\/td>\n
\n
\n
A date string in the format YYYY-MM-DD (e.g. 2011-12-23)<\/p>\n<\/div>\n<\/td>\n
\n
\n<\/div>\n<\/td>\n<\/tr>\n
\n
\n
dropdown<\/p>\n<\/div>\n<\/td>\n
\n
\n
A field to capture a single value from a predefined list of options.<\/p>\n<\/div>\n<\/td>\n
\n
\n
Options need to be defined in the additional options field.<\/p>\n<\/div>\n<\/td>\n<\/tr>\n
\n
\n
multiselect<\/p>\n<\/div>\n<\/td>\n
\n
\n
A field to capture multiple values from a predefined list of options.<\/p>\n<\/div>\n<\/td>\n
\n
\n
Options need to be defined in the additional options field.<\/p>\n<\/div>\n<\/td>\n<\/tr>\n
\n
\n
currency<\/p>\n<\/div>\n<\/td>\n
\n
\n
A value containing numbers representing a currency value.<\/p>\n<\/div>\n<\/td>\n
\n
\n
The value is a three-character ISO 4217<\/a> currency code. The value defaults to 'USD’.<\/p>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
\n
How to synchronise contact database?<\/h2>\n<\/div>\n
\n
1. Create a contact<\/b><\/h3>\n<\/div>\n
\n
Here are the list of standard fields:<\/p>\n<\/div>\n
\n