KlickTipp Listbuilding API (0.0.0)
This specification describes the KlickTipp Listbuilding API.
It is intended for external tools, websites, and automation platforms that integrate KlickTipp list-building functionality using API Key authentication. Typical use cases include newsletter sign-up forms, lead magnets, landing pages, and no-code or iPaaS-based automations.
The Listbuilding API provides a restricted and purpose-built interface for managing contacts without requiring full account authentication. Using an API key, external systems can add or update contacts, assign or remove a tag, trigger opt-in processes, or unsubscribe contacts from further communication.
All endpoints in this specification use API Key authentication.
The API key is generated in KlickTipp under:
Listbuilding → New Listbuilding → Entry via API key
Each API key is permanently linked to a specific opt-in process and tag. This defines the scope and behavior of the integration.
Authentication is performed by sending the API key directly in the request body. No session handling or cookies are required.
Documentation:
How to Create an API Key
This API is optimized for:
- External signup and opt-in forms
- Embedded integrations in websites such as WordPress or landing page builders
- Automated lead processing via third-party platforms
It is not intended for administrative workflows or full account management.
The Listbuilding API focuses on a small, stable set of endpoints designed for external systems:
Signin
Creates or updates a contact and associates the tag linked to the API keySignout
Removes the tag of a contact associated with the API keySignoff
Unsubscribes a contact via the API key and prevents further communication
The base URL for the KlickTipp API production environment is:
https://api.klicktipp.comAll endpoints defined in this specification are relative to this base URL.
The KlickTipp Listbuilding API uses JSON as its response format.
All endpoints return JSON responses containing structured payloads and error information. Integrations are expected to consume and validate JSON responses exclusively.
Date and time values must always be provided as Unix timestamps (seconds).
For the data field type Time only timestamps representing the first day of the Unix epoch date (00:00:00 UTC) are accepted. Any time-of-day information beyond the day boundary is rejected.
Formatted date strings, locale-specific formats, and timezone annotations are not supported.
Incorrect field formats are one of the most common causes of errors when using the Listbuilding API. Always ensure that submitted values match the expected field type definitions.
Documentation:
Data field types and Inputs
Errors are returned as JSON responses and typically use HTTP status code 403 or 406, depending on the failure type.
Each error includes a numeric error code that should be handled explicitly by the integrating system.
Documentation:
Error Handling
This specification is designed to support simple, secure, and predictable list-building integrations with KlickTipp.