# maxclicks docs > maxclicks is an agentic customer engagement platform. Give maxinja a goal to work on customer data, audiences, personal emails and workflows in your space. These docs explain the service for marketing teams and the public API for developers. Start with the customer outcome. Connect the relevant data and brand context, ask the agent to build the audience or email, and review the result before sending. Adaptyle writes selected email content for each recipient. Use the email guides to configure senders, personalize messages, and manage delivery. Product guides describe dashboard capabilities. API reference pages describe the operations available programmatically. ## Start here - [Email marketing automation documentation](https://docs.maxclicks.ai/): Docs for maxclicks email marketing automation: build a personal campaign with maxinja and Adaptyle, connect customer data, and use the API, SDKs and MCP server. - [API quickstart](https://docs.maxclicks.ai/quickstart): Make your first maxclicks API request, sync a customer record, and send a prepared template with authentication and safe retry handling. - [Send your first email](https://docs.maxclicks.ai/quickstart/send-your-first-email): Take a reviewed maxclicks email from draft to inbox: verify your sender, check the audience, send a test and inspect delivery results. - [Transactional vs Marketing Email](https://docs.maxclicks.ai/types-emails): Choose the correct maxclicks sending mode and understand consent, topics and unsubscribe handling for marketing and transactional email. ## maxclicks 101 (orientation course) - [Welcome to maxclicks 101](https://docs.maxclicks.ai/101): Understand the complete maxclicks service: customer context, AI agents, audiences, personalized email, lifecycle workflows, delivery, and developer integration. - [Your space, members and billing](https://docs.maxclicks.ai/101/account): Understand maxclicks workspace ownership, team roles, subscription components and AI credits. - [The data model](https://docs.maxclicks.ai/101/data-model): Understand the maxclicks data model: schemas, attributes, records and relationships that support customer audiences and personalized journeys. - [Understanding attributes](https://docs.maxclicks.ai/101/data-model/attributes): Choose maxclicks customer attributes, define their value types and defaults, and describe calculations for audiences and personalization. - [Understanding events](https://docs.maxclicks.ai/101/data-model/events): Understand maxclicks business events, their required context, duplicate handling and role in lifecycle workflows. - [Understanding records](https://docs.maxclicks.ai/101/data-model/records): Create and inspect maxclicks records, understand identity matching, and maintain the customer data used in campaigns. - [Connecting records](https://docs.maxclicks.ai/101/data-model/relationships): Connect maxclicks customer records to accounts, purchases and other business context through evaluated relationships. - [Understanding schemas](https://docs.maxclicks.ai/101/data-model/schemas): Define maxclicks schemas for customers and business objects, plan stable field keys, and prepare the model before importing data. - [Deliverability basics](https://docs.maxclicks.ai/101/deliverability): Understand maxclicks domain verification, consent, suppressions and email delivery signals before launching campaigns. - [Going further: connecting your own systems](https://docs.maxclicks.ai/101/developers): Plan the developer handoff for maxclicks: customer data, business events, saved email templates, API authentication and supported integration surfaces. - [Designing and personalizing email](https://docs.maxclicks.ai/101/email): Learn the maxclicks email composer, brand and data controls, and how Liquid and Adaptyle personalize the message. - [Glossary](https://docs.maxclicks.ai/101/glossary): Understand maxclicks customer data, calculated values, campaign states, AI personalization, workflows, sending and API terminology. - [Getting your data in](https://docs.maxclicks.ai/101/importing-data): Bring customer data into maxclicks through CSV, forms, individual records or the Public API, with clear identity and consent rules. - [Meet maxinja](https://docs.maxclicks.ai/101/maxinja): Direct maxclicks agents with a customer outcome, inspect the generated audience, email or journey, and refine the saved work. - [Getting around your space](https://docs.maxclicks.ai/101/navigating): Navigate the maxclicks workspace and locate customer records, audiences, campaigns, workflows, settings and AI assistance. - [Audiences and segments](https://docs.maxclicks.ai/101/segments): A segment is a saved filter over one contact schema. You describe the audience in plain language and maxinja builds the condition. - [Sending email](https://docs.maxclicks.ai/101/sending): Choose between maxclicks broadcasts, API-triggered templates and workflow emails, and understand marketing versus transactional sending. - [Automating with workflows](https://docs.maxclicks.ai/101/workflows): Understand maxclicks lifecycle workflows, customer context, step logic, publication and run history. ## maxinja (AI assistant) - [maxinja: turn a brief into a campaign](https://docs.maxclicks.ai/maxinja): Direct maxclicks agents to investigate customer data, build campaigns and journeys, and refine the audience, email and workflow from your brief. - [While maxinja works](https://docs.maxclicks.ai/maxinja/agentic): Follow maxinja’s saved changes, steer an active request, check the result and recover from an interrupted campaign or workflow task. - [The maxinja assistant](https://docs.maxclicks.ai/maxinja/assistant): Use the maxinja chat pane to attach workspace context, brief agents, steer active work and inspect saved results. ## Data model - [Attribute Expansion](https://docs.maxclicks.ai/attribute-expansion): Select on-demand and scheduled evaluated fields for emails and workflows, verify real samples, and understand freshness and pinned publications. - [Attributes](https://docs.maxclicks.ai/attributes): Choose stored fields, evaluated relationships and scheduled event measures, with creation defaults, publication states and freshness rules. - [Evaluated Attributes](https://docs.maxclicks.ai/evaluated-attributes): Create reusable customer calculations and relationships in maxclicks, review their results, and select them for audiences, email and workflows. - [Objects](https://docs.maxclicks.ai/objects): Use maxclicks objects to connect orders, products, subscriptions and accounts to customer audiences, personalized email and automation. - [Schemas](https://docs.maxclicks.ai/schemas): Define the customers, objects and events that give maxclicks agents context for audiences, personalized email and workflows. ## Contacts, audiences & events - [Contacts](https://docs.maxclicks.ai/contacts): Manage customer records, communication preferences, imports and suppressions in maxclicks, and understand how contact identity is matched. - [Events](https://docs.maxclicks.ai/events): Set up business events and typed collection sources, establish customer identity, inspect readiness, and turn activity into journeys and profile measures. - [Segments](https://docs.maxclicks.ai/segments): Build reusable maxclicks audiences from customer behavior and business data, review the matching contacts, and use them in campaigns and workflows. ## Brand - [Brand kits](https://docs.maxclicks.ai/brandkits): Build and publish maxclicks brand kits with reusable design assets, voice guidance and footer content for email and forms. - [Brand Voice](https://docs.maxclicks.ai/brandvoice): Give maxclicks agents practical brand voice guidance through values, tones and writing rules, then review it in personalized email samples. ## Email editor - [Email editor](https://docs.maxclicks.ai/editor): Build and review maxclicks email content across four editor modes, with brand kits, customer data, Liquid, Adaptyle and recipient previews. - [Data and recipient](https://docs.maxclicks.ai/editor/data): Define maxclicks email input data, recipients, evaluated fields and sample records for templates, broadcasts and workflow steps. - [Dynamic Composer](https://docs.maxclicks.ai/editor/dynamic): Build responsive maxclicks email layouts visually with Dynamic Composer sections, columns, content blocks and personalization. - [Fonts](https://docs.maxclicks.ai/editor/font): Configure maxclicks email typography in brand kits and individual blocks, with font fallbacks for different inboxes. - [HTML code editor](https://docs.maxclicks.ai/editor/html-code): Author or import HTML email in maxclicks, configure customer data and personalization, and review the result before sending. - [MJML Code Editor](https://docs.maxclicks.ai/editor/mjml-code): Author responsive MJML email in maxclicks with shared customer data, branding, Liquid and Adaptyle controls. - [Plain Composer](https://docs.maxclicks.ai/editor/plain): Write focused maxclicks emails in Plain Composer using visual HTML blocks, customer data and optional AI personalization. - [Sample data](https://docs.maxclicks.ai/editor/sample-data): Choose and inspect maxclicks email sample data, distinguish supplied records from generated examples, and review recipient previews. ## Personalization (Adaptyle & Liquid) - [Adaptyle](https://docs.maxclicks.ai/adaptyle): Use Adaptyle to adapt selected email passages to customer context, preserve fixed campaign facts, and review personalized samples before sending. - [Liquid](https://docs.maxclicks.ai/liquid): Use Liquid in maxclicks email to insert supplied values, format data and apply conditions alongside optional Adaptyle personalization. ## Marketing tools & workflows - [Broadcasts](https://docs.maxclicks.ai/broadcast): Build and review a maxclicks email campaign: audience conditions, personalized content, consent, scheduling and delivery results. - [Forms](https://docs.maxclicks.ai/forms): Create maxclicks signup forms with branded fields, explicit communication preferences and optional double opt-in, then publish or embed them. - [Sending to Large Audiences](https://docs.maxclicks.ai/large-audience): Prepare large maxclicks campaigns with clear audiences, consent checks, AI usage expectations, sending allowances and delivery monitoring. - [Templates](https://docs.maxclicks.ai/templates): Own recurring email content in maxclicks and let your application trigger it through REST or SMTP, using defined recipient data and personalization. - [Workflows](https://docs.maxclicks.ai/workflows): Build maxclicks customer journeys with AI agents, inspect triggers and conditions, publish the workflow, and follow individual run outcomes. - [Step logic and AI](https://docs.maxclicks.ai/workflows/ai): Understand maxclicks workflow logic, compiled conditions, runtime AI settings and how each choice affects execution and usage. - [Workflow billing](https://docs.maxclicks.ai/workflows/billing): Plan maxclicks workflow usage across runtime AI, metered tools, personalized email, sending allowances and concurrency limits. - [Workflow block library](https://docs.maxclicks.ai/workflows/blocks): Reference every maxclicks workflow block, including triggers, conditions, data operations, AI, delays and email actions. - [Create a workflow](https://docs.maxclicks.ai/workflows/create): Create and inspect a maxclicks workflow with customer triggers, configured steps, connected branches and a deliberate publication step. - [Manage workflows](https://docs.maxclicks.ai/workflows/manage): Manage maxclicks workflow publication, versions, pauses and copies while understanding what happens to existing runs. - [Workflow runs](https://docs.maxclicks.ai/workflows/run): Inspect maxclicks workflow runs, follow step outcomes and customer context, and diagnose where a journey failed. ## Deliverability - [Sending Avatars and Inbox Branding](https://docs.maxclicks.ai/avatar): Understand the distinction between maxclicks email branding, mailbox avatars and provider-controlled BIMI logo display. - [Domains](https://docs.maxclicks.ai/domain): Verify a maxclicks sending domain, configure DNS authentication and sender profiles, and resolve sending readiness issues. - [Google Postmaster Tools](https://docs.maxclicks.ai/postmaster): Use Google Postmaster Tools alongside maxclicks delivery reports to investigate Gmail spam reports, authentication and sender compliance. - [Root domain vs subdomain for sending email](https://docs.maxclicks.ai/subdomain): Root domain or subdomain for sending email? Use a subdomain such as mail.company.com for marketing email, and know what it does and does not isolate. ## Account & billing - [How billing works](https://docs.maxclicks.ai/billing): Understand your maxclicks subscription, included email, record packs and prepaid usage. See a worked monthly example and when your card is charged. - [Members](https://docs.maxclicks.ai/members): Manage maxclicks workspace roles, collaboration and maxinja access. Team access has no per-seat charge; roles control permissions. - [Your workspace](https://docs.maxclicks.ai/workspace): Manage maxclicks workspace identity, defaults, domains and settings for one business, with separate data and billing. ## Integrations - [Integrations](https://docs.maxclicks.ai/integration): Connect customer data with native integrations, REST, CSV and webhooks. Understand sync scope, record identity and ownership. - [Webhooks](https://docs.maxclicks.ai/webhooks): Subscribe to record and email events with signed POST deliveries you verify, and trigger workflows with incoming webhooks. ## MCP server - [maxclicks MCP Server](https://docs.maxclicks.ai/mcp-server): Connect Claude or another AI assistant to your workspace, then ask it in plain English to look up a contact, fire an event, count a segment, or send a template. ## API reference - [API reference](https://docs.maxclicks.ai/api): Connect your customer data to maxclicks. Authenticate, sync contacts, send events, trigger campaigns and journeys, and read results with the REST API. - [Attributes API reference](https://docs.maxclicks.ai/api/attributes): Read a schema's attributes. Attributes are authored in the app. - [Authentication](https://docs.maxclicks.ai/api/authentication): Authenticate maxclicks API requests with a Bearer API key or an OAuth access token. Roles, permissions, space resolution, key management, OAuth connections, and errors. - [Broadcasts API reference](https://docs.maxclicks.ai/api/broadcasts): Schedule, send, and measure mass emails. Broadcasts are authored in the app. - [Domains API reference](https://docs.maxclicks.ai/api/domains): Read sending domains and their DNS verification status. Domains are added and verified in the app. - [Emails API reference](https://docs.maxclicks.ai/api/emails): Public email recipient actions. - [Errors](https://docs.maxclicks.ai/api/errors): Handle maxclicks API failures with status codes, actionable error codes, bounded retries, and explicit checks for unresolved writes. - [Events API reference](https://docs.maxclicks.ai/api/events): Accept durable business events, inspect readiness, and bind anonymous source identities to contacts. - [Forms API reference](https://docs.maxclicks.ai/api/forms): Public form submission and double opt-in confirmation. - [Idempotency](https://docs.maxclicks.ai/api/idempotency): Retry supported maxclicks API writes with the same Idempotency-Key. Understand replayed results, conflicts, retention, and unresolved outcomes. - [Meta API reference](https://docs.maxclicks.ai/api/meta): Identify the calling API key. - [Pagination](https://docs.maxclicks.ai/api/pagination): List endpoints page with limit and offset; events.list uses cursor pagination with nextCursor. - [Rate limits](https://docs.maxclicks.ai/api/rate-limit): The Public API throttles per API key in three buckets: read 100/s, write 25/s, ai 10/min. Over the limit returns 429 with Retry-After. - [Records API reference](https://docs.maxclicks.ai/api/records): Keep stored contact and object data current, inspect consent history, and track deletion to completion. - [Schemas API reference](https://docs.maxclicks.ai/api/schemas): Read the space's schemas (contact, object, event). Schema definitions are authored in the app. - [Segments API reference](https://docs.maxclicks.ai/api/segments): Generate and manage AI-defined contact filters. - [Senders API reference](https://docs.maxclicks.ai/api/senders): Read saved sender profiles configured in the app. - [Suppressions API reference](https://docs.maxclicks.ai/api/suppressions): Manage the email do-not-contact list. Requires an admin key. - [Templates API reference](https://docs.maxclicks.ai/api/templates): Send stored message templates. Templates are authored in the app. - [Topics API reference](https://docs.maxclicks.ai/api/topics): Read communication topics configured in the app. - [Webhooks API reference](https://docs.maxclicks.ai/api/webhooks): Manage outgoing webhooks. - [Workflows API reference](https://docs.maxclicks.ai/api/workflows): Trigger published journeys, pause execution, and inspect runs and paged step history. ## More - [Build with AI](https://docs.maxclicks.ai/ai): Connect a coding agent to maxclicks with MCP, the CLI, agent skills, SDKs, or direct HTTP, then verify your workspace and start building. - [CLI](https://docs.maxclicks.ai/ai/cli): Install the maxclicks CLI, connect your workspace, and automate customer data and prepared campaigns with resource commands and JSON output. - [Use maxclicks in Bolt](https://docs.maxclicks.ai/ai/guides/bolt): Connect a Bolt app to maxclicks with server-side HTTP requests, a workspace API key, and the current API reference. - [Use maxclicks in Cursor](https://docs.maxclicks.ai/ai/guides/cursor): Connect Cursor to maxclicks with MCP tools, agent skills, and a workspace API key, then verify your connection before writing data. - [Use maxclicks in Lovable](https://docs.maxclicks.ai/ai/guides/lovable): Connect a Lovable app to maxclicks with backend HTTP requests. Verify your workspace and keep the API key in server-side secrets. - [Use maxclicks in Replit](https://docs.maxclicks.ai/ai/guides/replit): Connect a Replit project to maxclicks with a workspace API key, the Node SDK, CLI commands, or direct HTTP requests. - [Use maxclicks in v0](https://docs.maxclicks.ai/ai/guides/v0): Connect a v0 project to maxclicks with server-side HTTP requests. Verify the workspace first, then use the API quickstart to sync customer data. - [Use maxclicks in Windsurf](https://docs.maxclicks.ai/ai/guides/windsurf): Connect Windsurf to maxclicks with MCP tools and agent skills, and use a workspace key to read and update customer data. - [MCP server](https://docs.maxclicks.ai/ai/mcp): The maxclicks MCP server exposes the Public API as MCP tools. Connect a remote client by signing in with OAuth or with a space-scoped API key, or run it locally over stdio. - [Onboard an AI agent](https://docs.maxclicks.ai/ai/onboarding): Connect a coding agent to maxclicks, verify its workspace and schema, and set up agent skills, MCP, or the CLI. - [Agent Skills](https://docs.maxclicks.ai/ai/skills): Install maxclicks agent skills to teach your coding agent the data model, API conventions, and common integration workflows. - [AI and usage credits](https://docs.maxclicks.ai/billing/credits): Learn what consumes maxclicks credits, which balance pays, how AI charges are calculated, and how to estimate, monitor and top up your usage. - [maxclicks developer portal](https://docs.maxclicks.ai/developers): Everything developers need to build on maxclicks: API keys, the REST API reference, the OpenAPI specification, SDKs, the CLI, the MCP server, webhooks, rate limits and versioning. - [Guides](https://docs.maxclicks.ai/guides): Build personal emails, activate new signups and encourage repeat purchases. Practical maxclicks walkthroughs from customer data to a reviewed campaign. - [Manage billing](https://docs.maxclicks.ai/guides/billing): Check your plan and usage, add credits, download invoices and manage your maxclicks subscription. - [Set up your brand](https://docs.maxclicks.ai/guides/brand): Set up maxclicks brand assets, typography, colors and voice rules, then publish the kit for use in campaigns and forms. - [Send a broadcast](https://docs.maxclicks.ai/guides/broadcast): Create a maxclicks broadcast, review audience eligibility and personalized email samples, then send now or choose a schedule. - [Choose the right tool](https://docs.maxclicks.ai/guides/choose-your-tools): Know when to use maxinja, Adaptyle, evaluated attributes, workflow Query and AI steps, or Liquid for a customer campaign. - [Add your contacts](https://docs.maxclicks.ai/guides/contacts): Create and maintain maxclicks customer records with useful profile details and explicit communication preferences. - [Understand your data](https://docs.maxclicks.ai/guides/data): Turn business data into usable maxclicks customer context by defining record types, fields and evaluated calculations. - [Design an email](https://docs.maxclicks.ai/guides/design): Build a branded maxclicks email with a clear message, selected customer context and a rendered preview before sending. - [Connect your domain](https://docs.maxclicks.ai/guides/domain): Connect and verify your maxclicks email domain, add the supplied DNS records and confirm readiness for real sends. - [Create your first personalized email](https://docs.maxclicks.ai/guides/first-personalized-email): Build one email, supply three customer profiles and compare finished Adaptyle previews. Follow the customer facts into the message before sending. - [Create a signup form](https://docs.maxclicks.ai/guides/forms): Build and publish a branded maxclicks signup form with declared contact fields, clear preferences and optional double opt-in. - [Import a contact list](https://docs.maxclicks.ai/guides/import): Import customer records into maxclicks with matching CSV field keys, explicit consent defaults and a review of accepted and failed rows. - [Meet maxinja](https://docs.maxclicks.ai/guides/maxinja): Direct maxclicks agents with a campaign brief, relevant customer context and clear constraints, then inspect and refine their saved work. - [What you can ask maxinja to do](https://docs.maxclicks.ai/guides/maxinja-tasks): Use practical maxinja briefs for audience analysis, campaign creation, email refinement and customer journeys, with clear review criteria. - [Personalize with AI](https://docs.maxclicks.ai/guides/personalize): Personalize selected email passages with maxclicks Adaptyle, preserve fixed campaign facts, and compare real recipient previews. - [Build a repeat-purchase campaign](https://docs.maxclicks.ai/guides/repeat-purchase): Use order history to select returning customers, give Adaptyle product and preference context, and inspect a repeat-purchase email before sending. - [See your results](https://docs.maxclicks.ai/guides/reports): Read maxclicks campaign and workspace email metrics, distinguish delivery from response, and identify what to investigate next. - [Create a segment](https://docs.maxclicks.ai/guides/segments): Translate customer behavior into a reusable maxclicks segment, inspect its condition and matching records, and refine the audience. - [Set up your space](https://docs.maxclicks.ai/guides/setup): Set up your maxclicks workspace, business identity and customer model, then verify the domain used to send email. - [Invite your team](https://docs.maxclicks.ai/guides/team): Invite your team to maxclicks and assign workspace roles for campaign editing, administration and billing. - [Reuse a template](https://docs.maxclicks.ai/guides/templates): Create reusable maxclicks email templates and define the recipient data your developer supplies when triggering each message. - [Take a tour of the app](https://docs.maxclicks.ai/guides/tour): Tour the maxclicks workspace from customer data and AI agents through audiences, campaigns, workflows and results. - [Activate new signups](https://docs.maxclicks.ai/guides/workflows): Build a signup follow-up that waits two days, checks each person’s own projects and emails only the people who have not started. - [Link tracking](https://docs.maxclicks.ai/link-tracking): Configure marketing-email UTM tags, choose campaign names, understand which links are changed, and verify the destination separately from email click metrics. - [SDKs](https://docs.maxclicks.ai/sdks): Connect customer data, events, and prepared campaigns with maxclicks client libraries. Compare languages, installation paths, authentication, and retry behavior. - [Elixir SDK](https://docs.maxclicks.ai/sdks/elixir): The official maxclicks Elixir SDK: install with Hex and call the Public API v1 with tagged tuples and typed structs. - [Go SDK](https://docs.maxclicks.ai/sdks/go): The official Go client for the maxclicks Public API v1: context-first methods, typed errors, retries, pagination, and idempotency. - [Java SDK](https://docs.maxclicks.ai/sdks/java): The official maxclicks Java SDK: install with Maven or Gradle, build a client, upsert a record, and handle typed errors. - [Node.js SDK](https://docs.maxclicks.ai/sdks/node): The official maxclicks Node.js and TypeScript SDK for the Public API v1: installation, client setup, typed errors, and auto-pagination. - [PHP SDK](https://docs.maxclicks.ai/sdks/php): Official maxclicks PHP SDK: install maxclicks/maxclicks-php with Composer, construct a client, call the Public API v1, and use the Laravel bridge. - [Python SDK](https://docs.maxclicks.ai/sdks/python): The official maxclicks Python SDK: install with pip, initialize the client, upsert records, paginate, and handle typed errors. - [Ruby SDK](https://docs.maxclicks.ai/sdks/ruby): The maxclicks Ruby gem: install with Bundler, build a client, upsert records, auto-paginate, and handle typed errors. - [Rust SDK](https://docs.maxclicks.ai/sdks/rust): The maxclicks Rust SDK (crate maxclicks) is the official synchronous client for the Public API v1, with typed errors, retries, and auto-pagination. - [Setup changes](https://docs.maxclicks.ai/setup-changes): Change customer fields and event contracts, inspect converted values and affected campaigns, and follow review, application and recovery through completion. ## Developer resources - [maxclicks developer portal](https://docs.maxclicks.ai/developers): API keys, the API reference, SDKs, the CLI, the MCP server, rate limits and versioning in one place. - [maxclicks API authentication](https://docs.maxclicks.ai/api/authentication): API keys, OAuth connections, permissions and rate-limit headers. - [OpenAPI specification](https://docs.maxclicks.ai/api-spec/openapi.json): the machine-readable contract for the public REST API. - [maxclicks SDKs](https://docs.maxclicks.ai/sdks): client libraries for Node.js, Python, PHP, Ruby, Go, Java, Rust and Elixir. - [maxclicks CLI](https://docs.maxclicks.ai/ai/cli): the `maxclicks-cli` npm package, JSON commands for terminals and coding agents. - [maxclicks MCP server](https://docs.maxclicks.ai/ai/mcp): connect an AI assistant over Streamable HTTP at https://mcp.maxclicks.ai/mcp. Server card: https://docs.maxclicks.ai/.well-known/mcp/server-card.json. - [maxclicks app](https://app.maxclicks.ai): sign in to your space. - [Current pricing](https://maxclicks.ai/pricing): monthly workspace pricing, included record/email capacity, unlimited collaborators and separately paid AI usage without an allowance or credit gift. ## Optional - [Full documentation text](https://docs.maxclicks.ai/llms-full.txt): product guides and generated API operations, with a source URL for each page. This file is an optional reading index. It does not replace the public pages, OpenAPI contract, sitemap or crawler access rules.