Skip to content
Developers
Docs

maxclicks for developers

Build customer engagement into your product.

Connect your data. Capture events. Give your code and agents the tools to make every message personal.

Start building Explore the code

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

Works where you build.

Collect activity in the browser. Connect records and send prepared emails on the server. Keep secrets where they belong.

In the browser.

Typed events, consent controls, persistent queues, and a backend identity handoff.

npm install @maxclicks/browser
  • Explicit consent
  • Queuing and retries
  • Public source keys
Explore browser events

On your server.

A typed Node.js client for customer records, events, saved templates, and workflows.

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

From your terminal to your scripts.

Inspect customer data, trigger prepared workflows, and read campaign results. The CLI returns JSON your scripts can use.

Use the CLI 
npm install -g maxclicks-cli
export MAXCLICKS_API_KEY="YOUR_API_KEY"

maxclicks whoami
maxclicks records list customers --limit 5

Use an existing schema ID or slug in place of customers.

Your agents can work here, too.

Connect an MCP-compatible assistant to your workspace. Let it inspect customer data, manage records, and work with prepared campaigns.

Connect with MCP

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

Find your language and its supported operations.

MCP server

Connect your assistant to your workspace.

Agent skills

Give your coding agent the platform context.