Skip to content
Developers
Docs

maxclicks for developers

Build customer engagement into your product.

Connect your data, capture events and send personal emails through the REST API, an SDK, the CLI or MCP.

Keep customer data connected.

Create or update contacts and business objects using the identifiers your application already knows.

Read the API reference

Use your contact schema’s ID or slug. Keep the API key on your server.

upsert-contact.sh
curl --fail-with-body \
  https://api.maxclicks.ai/v1/schemas/customers/records/upsert \
  -H "Authorization: Bearer $MAXCLICKS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: signup:customer_42" \
  -d '{
    "userId": "customer_42",
    "email": "[email protected]",
    "firstName": "Nadia"
  }'

Your customer model.
One API.

Connect people to the accounts, orders, and activity that explain what they need. Use that context across campaigns and journeys.

Customer data model
customers
userId
customer_42
firstName
Nadia
Related records
orders
orderId
order_1042
amount
149
products
productId
ridge-01
category
Trail running

Example schemas. Your business defines the fields.

More than a contact list.

Keep customers, orders, accounts, and other business objects current in your workspace’s data model.

Let product activity start the journey.

Send a business event or trigger a prepared workflow through its incoming-webhook step.

Your application. Your team’s email.

Send a saved template with customer data while your team manages its design and Adaptyle instructions in maxclicks.

Bring the response back to your system.

Receive signed webhooks for record changes, business events, and email activity such as deliveries and clicks.

Authorization: Bearer $MAXCLICKS_API_KEYOpenAPI specification

Events that keep their context.

Track what happens in your product. Pass the event into a configured journey with the customer data that makes the follow-up relevant.

Example
Browser SDK

A product is viewed.

analytics.ts
await analytics.track(
  'product_viewed',
  { product_id: 'ridge-01' },
)

Collect after consent is granted.

Your backend links the person.

Source key
Public, observation-only
Identity
Linked by your authenticated backend
Schema-checked observation

product_viewed

Matches its published definition, with properties and anonymous identity intact.

A queued result confirms local enqueue. Delivery is tracked separately.

Keep your systems in the loop.

Signed webhooks bring record changes and email activity back to your application.

Webhook reference

SDKs for the browser and your server.

Install a package to connect records, record events and send prepared emails. Every SDK speaks the same public REST API.

In the browser.

The Browser SDK includes typed events, consent controls, persistent queues, and a backend identity handoff.

npm install @maxclicks/browser
  • Explicit consent
  • Queuing and retries
  • Public source keys
Set up event collection

On your server.

The Node.js SDK connects customer records, events, saved templates, and workflows.

npm install maxclicks
  • Typed errors
  • Pagination helpers
  • Idempotency support
Read the Node.js guide

A CLI for your terminal.

Work with records, prepared workflows and campaign results from your terminal, scripts or coding agent. Every command returns JSON.

Read the CLI guide 
npm install -g maxclicks-cli
maxclicks login
maxclicks whoami

Sign in, then confirm the workspace before a write.

Connect your assistant with MCP.

Add the maxclicks MCP server to Claude, ChatGPT, Cursor or any MCP client. Sign in, choose the workspace and what the assistant may do, and it works with customer records, events and prepared campaigns.

Connect the MCP server

MCP tools

Read-only toolExample

whoami

{}

Confirm the API key’s owner, workspace and role before acting.

Skills for coding agents

Give agents the API context and integration instructions to build with maxclicks.

Built on the same platform

You supply the context.
Adaptyle makes it personal.

Send a saved template with your customer data. Adaptyle writes the instructed passages as each email is prepared for delivery.

Meet Adaptyle
Customer dataSaved templatePersonal email

Everything to get started.

HTTP quickstart

Connect a customer and send a prepared template.

API reference

Explore requests, responses, and authentication.

OpenAPI specification

Use the current JSON contract in your own tools.

Client libraries

Install an SDK in your language.

MCP server

Connect an assistant and choose what it may do.

Agent skills

Give your coding agent the platform context.