{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["integrationSummary"]},"type":"markdown"},"seo":{"title":"Choosing Between the Listbuilding API and the Management API","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":"Help integrators choose the correct KlickTipp API model before they implement authentication, payload mapping, or automation behavior.","requiredEndpoints":["POST /subscriber/signin.json","GET /subscriber.json","POST /subscriber.json","GET /list.json","GET /tag.json"],"decisionRules":["Use the Listbuilding API when one API key controls one predefined opt-in flow.","Use the Management API when the integration must read data first or react to multiple business events."],"failureHandling":["Treat a wrong API choice as a design issue, not a transient runtime error.","For request-level failures, follow Error Handling and Validation."],"knownLimits":["The Listbuilding API cannot replace a general-purpose event-driven integration.","This guide helps with API selection only; it does not document every endpoint in detail."],"relatedDocs":[{"label":"Listbuilding API","href":"/guides/listbuilding-api"},{"label":"Management API","href":"/guides/management-api"},{"label":"Error Handling and Validation","href":"/guides/error-handling"}]}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"choosing-between-the-listbuilding-api-and-the-management-api","__idx":0},"children":["Choosing Between the Listbuilding API and the Management API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide explains when to use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Listbuilding API"]}," and when to use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Management API"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The short version is:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Listbuilding API"]}," for a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["fixed opt-in flow"]}," tied to a specific list-building process."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Management API"]}," for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["event-driven integrations"]}," that need to read or change contacts, tags, fields, or opt-in process data in a more flexible way."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"decision-tree","__idx":1},"children":["Decision Tree"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Do you want to send a contact into one predefined opt-in flow?\n|\n+-- Yes\n|   |\n|   +-- Is the integration centered around an API key that belongs to that\n|       list-building process?\n|       |\n|       +-- Yes -> Use the Listbuilding API\n|       +-- No  -> Re-check your design. A fixed opt-in flow usually belongs in\n|                  the Listbuilding API.\n|\n+-- No\n    |\n    +-- Do you need to react to business events or manage contact data\n        dynamically?\n        |\n        +-- Yes -> Use the Management API\n        +-- No  -> If your only job is still a predefined opt-in path, use the\n                   Listbuilding API\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-the-listbuilding-api-when","__idx":2},"children":["Use the Listbuilding API When"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Choose the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Listbuilding API"]}," if your integration is essentially a controlled signup flow."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Typical fit:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A website form sends leads into one predefined opt-in process"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A funnel tool pushes contacts into one fixed subscription flow"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An integration only needs API-key-based ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signin"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signout"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signoff"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The business logic is intentionally limited to a specific acquisition path"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Key characteristics:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Authentication is based on an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API key"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The API key is linked to a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["list-building process"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The flow is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["predefined"]},", not dynamically assembled at runtime"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["It is well suited for simple external lead capture scenarios"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Relevant endpoints:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /subscriber/signin.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /subscriber/signout.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /subscriber/signoff.json"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["What this means in practice:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signin"]}," is the entry point for sending a contact into the fixed opt-in flow"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signout"]}," removes a tag in the API-key-driven flow"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signoff"]}," unsubscribes a contact in the API-key-driven flow"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-the-management-api-when","__idx":3},"children":["Use the Management API When"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Choose the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Management API"]}," if your integration is driven by events, decisions, or ongoing data synchronization."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Typical fit:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A workflow reacts to purchases, webinar attendance, CRM changes, or support events"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You need to create, update, search, tag, untag, or unsubscribe contacts dynamically"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You need to inspect tags, fields, contacts, or opt-in processes before deciding what to do"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You are building an iPaaS, SaaS, MCP, automation, or backend integration with flexible runtime behavior"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Key characteristics:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Designed for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["event-driven flows"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Supports broader contact and metadata management"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Works for integrations that need to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["read first, then decide"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Better fit when logic is based on conditions, branching, or multiple KlickTipp objects"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Relevant endpoint groups:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contacts:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /subscriber.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /subscriber.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /subscriber/{subscriberid}.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT /subscriber/{subscriberid}.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE /subscriber/{subscriberid}.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /subscriber/search.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /subscriber/tagged.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /subscriber/unsubscribe.json"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact tagging:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /subscriber/tag.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /subscriber/untag.json"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Data fields:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /field.json"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Opt-in processes:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /list.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /list/{listid}.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /list/redirect.json"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tags:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /tag.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /tag.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /tag/{tagid}.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT /tag/{tagid}.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE /tag/{tagid}.json"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"side-by-side-comparison","__idx":4},"children":["Side-by-Side Comparison"]},{"$$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":"Question"},"children":["Question"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Listbuilding API"},"children":["Listbuilding API"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Management API"},"children":["Management API"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Main purpose"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fixed opt-in flow"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Event-driven contact and metadata management"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Best for"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Forms, funnels, simple lead capture"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Automations, sync jobs, backend logic, iPaaS, AI and MCP tools"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication style"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API key"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Session auth or partner auth, depending on integration mode"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Runtime flexibility"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Low"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["High"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reads existing KlickTipp data before acting"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Usually no"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Works well for branching logic"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact management beyond one intake flow"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Limited"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"do-not-use-the-listbuilding-api-when","__idx":5},"children":["Do Not Use the Listbuilding API When"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Listbuilding API"]}," if:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You need to decide at runtime which tags, fields, or actions to apply"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You need to look up existing contacts before acting"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You need to manage tags or fields outside the fixed opt-in flow"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You need a general-purpose integration for Make, Zapier, n8n, MCP, or custom backend services"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You need to support multiple business events such as purchase, cancellation, enrichment, or support-state changes"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In these cases, use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Management API"]}," instead."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"do-not-use-the-management-api-when","__idx":6},"children":["Do Not Use the Management API When"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Management API"]}," if:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your only goal is to send a lead into one predefined list-building flow"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You intentionally want a narrow API-key-based signup integration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your integration is basically a form submission with a fixed opt-in path and no broader contact-management logic"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In these cases, the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Listbuilding API"]}," is usually the cleaner choice."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"practical-examples","__idx":7},"children":["Practical Examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-1-newsletter-signup-form","__idx":8},"children":["Example 1: Newsletter signup form"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Scenario:"," ","A landing page form should send a contact into one predefined double opt-in process."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Recommendation:"," ","Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Listbuilding API"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Why:"," ","The flow is fixed, API-key-based, and focused on lead capture."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-2-purchase-automation","__idx":9},"children":["Example 2: Purchase automation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Scenario:"," ","After a payment, the integration should find the contact, update fields, add tags, and maybe trigger a different follow-up path depending on product or amount."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Recommendation:"," ","Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Management API"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Why:"," ","This is event-driven logic with branching and dynamic contact management."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-3-crm-sync","__idx":10},"children":["Example 3: CRM sync"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Scenario:"," ","A CRM pushes updates into KlickTipp whenever account data changes."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Recommendation:"," ","Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Management API"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Why:"," ","This is not a fixed opt-in flow. It is ongoing synchronization and contact management."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-4-lead-magnet-form-inside-a-funnel-builder","__idx":11},"children":["Example 4: Lead magnet form inside a funnel builder"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Scenario:"," ","A simple external tool should register a lead for one specific opt-in process."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Recommendation:"," ","Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Listbuilding API"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Why:"," ","The integration only needs the predefined signup path."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"recommended-rule-of-thumb","__idx":12},"children":["Recommended Rule of Thumb"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this simple rule:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the integration starts with ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"put this lead into this predefined opt-in flow\""]},", use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Listbuilding API"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the integration starts with ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"when this event happens, inspect data and decide what to do\""]},", use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Management API"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-notes","__idx":13},"children":["Related Notes"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Listbuilding API centers on the API-key functions ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signin"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signout"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signoff"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Management API covers the broader operational surface for contacts, tags, fields, and opt-in-process inspection."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If an integration may grow from a simple signup flow into broader event-driven automation, it is usually better to plan around the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Management API"]}," from the start."]}]}]},"headings":[{"value":"Choosing Between the Listbuilding API and the Management API","id":"choosing-between-the-listbuilding-api-and-the-management-api","depth":1},{"value":"Decision Tree","id":"decision-tree","depth":2},{"value":"Use the Listbuilding API When","id":"use-the-listbuilding-api-when","depth":2},{"value":"Use the Management API When","id":"use-the-management-api-when","depth":2},{"value":"Side-by-Side Comparison","id":"side-by-side-comparison","depth":2},{"value":"Do Not Use the Listbuilding API When","id":"do-not-use-the-listbuilding-api-when","depth":2},{"value":"Do Not Use the Management API When","id":"do-not-use-the-management-api-when","depth":2},{"value":"Practical Examples","id":"practical-examples","depth":2},{"value":"Example 1: Newsletter signup form","id":"example-1-newsletter-signup-form","depth":3},{"value":"Example 2: Purchase automation","id":"example-2-purchase-automation","depth":3},{"value":"Example 3: CRM sync","id":"example-3-crm-sync","depth":3},{"value":"Example 4: Lead magnet form inside a funnel builder","id":"example-4-lead-magnet-form-inside-a-funnel-builder","depth":3},{"value":"Recommended Rule of Thumb","id":"recommended-rule-of-thumb","depth":2},{"value":"Related Notes","id":"related-notes","depth":2}],"frontmatter":{"title":"Choosing Between the Listbuilding API and the Management API","contract":{"purpose":"Help integrators choose the correct KlickTipp API model before they implement authentication, payload mapping, or automation behavior.","requiredEndpoints":["POST /subscriber/signin.json","GET /subscriber.json","POST /subscriber.json","GET /list.json","GET /tag.json"],"decisionRules":["Use the Listbuilding API when one API key controls one predefined opt-in flow.","Use the Management API when the integration must read data first or react to multiple business events."],"failureHandling":["Treat a wrong API choice as a design issue, not a transient runtime error.","For request-level failures, follow Error Handling and Validation."],"knownLimits":["The Listbuilding API cannot replace a general-purpose event-driven integration.","This guide helps with API selection only; it does not document every endpoint in detail."],"relatedDocs":[{"label":"Listbuilding API","href":"/guides/listbuilding-api"},{"label":"Management API","href":"/guides/management-api"},{"label":"Error Handling and Validation","href":"/guides/error-handling"}]},"seo":{"title":"Choosing Between the Listbuilding API and the Management API"}},"lastModified":"2026-07-21T15:49:41.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/api-selection-rules","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}