{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["integrationSummary"]},"type":"markdown"},"seo":{"title":"Data Field Types and Input Formats","description":"Official KlickTipp API documentation. Learn how to authenticate, integrate external systems, and build reliable automations using the KlickTipp API.","lang":"en-US","siteUrl":"https://developers.klicktipp.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"IntegrationSummary","attributes":{"contract":{"purpose":"Define the normative field-value formats that integrations must send when they create or update contact data in KlickTipp.","requiredEndpoints":["POST /subscriber/signin.json","POST /subscriber.json","PUT /subscriber/{subscriberid}.json"],"decisionRules":["Match every submitted value to the configured KlickTipp field type before sending the request.","Send time-based fields in the documented timestamp or seconds format."],"failureHandling":["If the API returns a 406 validation error, correct the payload before retrying.","Log which field key and value failed so the integration can show an actionable error."],"knownLimits":["The API does not expose field metadata or field types for automatic validation.","This guide covers field formats, not authentication or full request payload design."],"relatedDocs":[{"label":"Error Handling and Validation","href":"/guides/error-handling"},{"label":"Management API","href":"/guides/management-api"}]}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"data-field-types-and-input-formats","__idx":0},"children":["Data Field Types and Input Formats"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When submitting contact data via the KlickTipp Listbuilding API, all values must match the field types and field keys configured in your KlickTipp account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The KlickTipp API does ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," provide endpoints to retrieve field definitions or metadata.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Your integration must therefore ensure that values are sent in the correct format."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This document describes all supported field types and their expected input formats."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"general-rules","__idx":1},"children":["General Rules"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Field keys must exactly match the keys configured in the KlickTipp account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Values must conform to the expected field type"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Invalid formats will result in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/error-handling#business-and-validation-errors"},"children":["validation errors"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Date and time fields must always be sent as Unix timestamps"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-field-types","__idx":2},"children":["Supported Field Types"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field type"},"children":["Field type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Comment"},"children":["Comment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Example"},"children":["Example"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Line"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String, single-line text"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Alex"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Paragraph"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String, line breaks allowed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Line 1 \\n Line 2"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["E-mail"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Valid email string, must contain ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alex.example@klicktipp.example"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Integer, send as numeric value, not as string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["100"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Decimal number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Integer, send value multiplied by 100. The UI displays value divided by 100 with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["."]}," (UI: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["19.99"]},")."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1999"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Absolute URL, must start with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["http://"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://www.klicktipp.example"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unix timestamp in seconds, do not send formatted date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["755222400"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Date & time"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unix timestamp in seconds, not milliseconds"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1715603400"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Time"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seconds since midnight (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0-86399"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["52200"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"important-validation-notes","__idx":3},"children":["Important Validation Notes"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use Unix timestamps in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["seconds"]}," only, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["755222400"]},", not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["755222400000"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For numeric custom fields, send numeric values as numbers when possible, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["100"]}," instead of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"100\""]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Decimal number fields expect a scaled integer (factor 100), not a literal decimal string. Send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1999"]}," to display ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["19.99"]}," in the UI."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Phone values such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["+491701234567"]}," are text values and should be treated as strings."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"date-and-time-fields","__idx":4},"children":["Date and Time Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Although date and time values are displayed as formatted strings in the KlickTipp UI, the API ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["always expects Unix timestamps"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This applies to the following field types."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Time"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Date"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Date & time"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sending formatted date strings instead of timestamps will result in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/error-handling#business-and-validation-errors"},"children":["field validation errors"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-validation-mistakes","__idx":5},"children":["Common Validation Mistakes"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sending formatted date strings instead of Unix timestamps"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sending decimal values to integer number fields"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Using invalid URLs without protocol"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sending text values to numeric fields"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Using incorrect or outdated field keys"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a value does not match the expected field type, the API will reject the request with a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/error-handling#business-and-validation-errors"},"children":["field validation error"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"summary","__idx":6},"children":["Summary"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["All values must match the configured field type in the KlickTipp account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Date and time fields must always be sent as Unix timestamps"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Invalid formats result in field validation errors, not silent coercion"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Correct field mapping is the responsibility of the integration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The API does not expose field metadata or field types"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-topics","__idx":7},"children":["Related Topics"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/error-handling"},"children":["Subscription Error Handling & Validation Errors"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/listbuilding-api"},"children":["Listbuilding API Reference"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/management-api"},"children":["Management API Reference"]}]}]}]},"headings":[{"value":"Data Field Types and Input Formats","id":"data-field-types-and-input-formats","depth":1},{"value":"General Rules","id":"general-rules","depth":2},{"value":"Supported Field Types","id":"supported-field-types","depth":2},{"value":"Important Validation Notes","id":"important-validation-notes","depth":3},{"value":"Date and Time Fields","id":"date-and-time-fields","depth":2},{"value":"Common Validation Mistakes","id":"common-validation-mistakes","depth":2},{"value":"Summary","id":"summary","depth":2},{"value":"Related Topics","id":"related-topics","depth":2}],"frontmatter":{"title":"Data Field Types and Input Formats","contract":{"purpose":"Define the normative field-value formats that integrations must send when they create or update contact data in KlickTipp.","requiredEndpoints":["POST /subscriber/signin.json","POST /subscriber.json","PUT /subscriber/{subscriberid}.json"],"decisionRules":["Match every submitted value to the configured KlickTipp field type before sending the request.","Send time-based fields in the documented timestamp or seconds format."],"failureHandling":["If the API returns a 406 validation error, correct the payload before retrying.","Log which field key and value failed so the integration can show an actionable error."],"knownLimits":["The API does not expose field metadata or field types for automatic validation.","This guide covers field formats, not authentication or full request payload design."],"relatedDocs":[{"label":"Error Handling and Validation","href":"/guides/error-handling"},{"label":"Management API","href":"/guides/management-api"}]},"seo":{"title":"Data Field Types and Input Formats"}},"lastModified":"2026-07-21T15:49:41.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/data-field-types","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}