canonical: https://jentic.com/apis/klick-tipp.com/klick-tipp # KlickTipp API Jentic publishes the only available OpenAPI specification for KlickTipp API, keeping it validated and agent-ready. KlickTipp is a German email marketing platform centred on tag-based subscriber automation rather than list management. The API exposes session login and logout, subscriber records, tags, and the link between the two, so an integrator can sync subscribers from a CRM, tag them based on behaviour, and trigger downstream automations inside KlickTipp. It suits SMBs and consultancies that already run their nurture sequences in KlickTipp and want to attach external systems to its tag-driven flows. ## For AI agents Sync subscribers, manage tags, and trigger tag-based automations on the KlickTipp email marketing platform. ## Scope Does not handle template design, transactional email delivery, or SMS - use for tag-based subscriber automation in KlickTipp only. ## Capabilities - Authenticate a session against KlickTipp using account credentials - Add and update KlickTipp subscribers from an external CRM - Look up a KlickTipp subscriber by id with their tag assignments - Create tags inside KlickTipp to drive segmentation rules - Apply or remove a tag on a subscriber to trigger an automation - Inspect a tag definition and the subscribers attached to it ## Use cases ### CRM-to-KlickTipp Subscriber Sync Mirror contacts from an external CRM into KlickTipp so marketing automations stay in sync with sales reality. POST /subscriber adds a new record and PATCH on `/subscriber/{id}` keeps fields current. Tags applied via `/subscriber/{id}/tag` fire the tag-based automations that KlickTipp users rely on, replacing brittle Zapier chains with a direct integration. Example prompt: Create a KlickTipp subscriber for email lead@example.com and apply the tag 'crm-imported' to trigger the welcome automation. ### Behavioural Tag Triggering Drive KlickTipp automations from product or webinar behaviour. The `/subscriber/{id}/tag` endpoint applies a tag in real time, which fires whatever sequence the marketer has wired to that tag. Saves teams from rebuilding flows in KlickTipp every time the source-of-truth event changes. Example prompt: When user 12345 attends webinar 'launch-2026', POST to `/subscriber/12345/tag` with the tag 'webinar-attended-launch-2026'. ### Tag Hygiene and Audit Keep KlickTipp tag taxonomy clean by inventorying tags and auditing usage. The /tag endpoint lists all configured tags and `/tag/{id}` returns the per-tag detail needed to spot duplicates, deprecated names, and stale segments. Useful for marketing operators inheriting an account that has accumulated years of ad-hoc tags. Example prompt: List all KlickTipp tags via GET /tag and report any whose name contains 'old' or 'test' so they can be retired. ### Agent-Driven Lifecycle Updates via Jentic Have an AI agent listen to product events and update the right KlickTipp tag without a marketer in the loop. The agent searches Jentic for the matching subscriber or tag operation, loads the schema, and executes with the session credentials kept in your Jentic One instance. This collapses CRM and automation glue code into a few intent-named tool calls. Example prompt: Through Jentic, search for 'apply a tag in KlickTipp', load `/subscriber/{id}/tag`, and tag subscriber 12345 with 'paid-customer'. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/subscriber/login` | Log into a KlickTipp session | | POST | `/subscriber/logout` | End the current KlickTipp session | | POST | `/subscriber` | Create a subscriber | | GET | `/subscriber/{id}` | Retrieve a subscriber | | GET | `/tag` | List tags | | POST | `/subscriber/{id}/tag` | Apply a tag to a subscriber | ## Key resources - **Auth** — Log in and out of a KlickTipp session - **Subscribers** — Create, update, and look up subscribers - **Tags** — List and manage tags used to drive automations - **Subscriber Tags** — Apply or remove tags on a specific subscriber ## Why Jentic - **Setup:** Wiring KlickTipp by hand means logging in for a session cookie, replaying it against the api.klick-tipp.com host on every call, and handling logout yourself. Through Jentic you install once, import KlickTipp from the API Directory, store the credential once, and your agent calls it. - **Permission scoping:** KlickTipp identifies a subscriber in the URL path (`/subscriber/{id}`), but tagging targets and tags travel in the request, so scope by operation: limit the agent to the operations it needs, such as reading a subscriber or listing tags, and leave subscriber creation or tag application out unless you add them. - **Credential handling:** Your KlickTipp credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'look up a subscriber' or 'list available tags', and Jentic returns the matching KlickTipp operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **ConvertKit (Kit) API** — Tag-based creator email marketing platform with similar automation model - **Mailchimp API** — Mainstream list-and-tag email marketing platform with broader template tooling - **Airtable API** — Common back-of-house store for the contact records pushed into KlickTipp ## FAQ ### Why is there no official OpenAPI spec for KlickTipp API? KlickTipp does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call KlickTipp API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer. ### What authentication does the KlickTipp API use? The KlickTipp API uses session-cookie authentication. POST `/subscriber/login` exchanges the username and key for a session cookie that subsequent requests must carry. Through Jentic, the credentials are stored in your Jentic One instance and the session cookie is managed for the agent. ### Can I trigger an email automation via the KlickTipp API? Indirectly, yes. KlickTipp automations are tag-driven, so applying a tag with POST `/subscriber/{id}/tag` fires whatever sequence the marketer has attached to that tag. There is no separate 'trigger campaign' endpoint - the tag is the trigger. ### What are the rate limits for the KlickTipp API? KlickTipp does not publish a public rate limit. Treat the API as moderately throttled per session; batch subscriber writes where possible and avoid login storms by reusing the session cookie within its lifetime. ### How do I add a subscriber from an AI agent through Jentic? Search Jentic for 'add a KlickTipp subscriber', load POST /subscriber, and execute with the email and any extra fields. Jentic handles the `/subscriber/login` step using vaulted credentials so the agent only deals with the create call. ### Can I list all tags in my KlickTipp account? Yes. GET /tag returns the full list of tags configured in the account. Use this to audit taxonomy or to look up the tag id needed by `/subscriber/{id}/tag.` ### Can I limit what my agent is allowed to do with the KlickTipp API? Yes. Because you run Jentic One yourself, your own rules decide which KlickTipp operations the agent can call and which credential it uses. Since KlickTipp scopes access by operation rather than by record, you can grant read-only calls such as retrieving a subscriber with GET `/subscriber/{id}` or listing tags with GET /tag while leaving write operations like POST /subscriber or applying a tag with POST `/subscriber/{id}/tag` out unless you explicitly add them. The session credential stays in your own instance and is injected only for the operations you allow.