Developer + operator docs

Use the service API, embed forms, and dashboard workflows with the real contract in hand.

This page covers the current ListMint integration surface: workspace API keys, the service API endpoints, embed-form installation, and the dashboard flows that manage lists, forms, reports, and inbound messages.

Create a workspace application in the Developer page, issue an API key once, and send it as x-api-key on requests to /service-api/v1. The machine-readable contract lives at /service-api/openapi.json.

Quick start

curl -H "x-api-key: nak_your_prefix.your_secret" \
  https://listmint.us/service-api/v1/lists

curl -H "x-api-key: nak_your_prefix.your_secret" \
  https://listmint.us/service-api/v1/lists/list_123/subscribers

curl -H "x-api-key: nak_your_prefix.your_secret" \
  https://listmint.us/service-api/v1/usage

Embed forms

Build forms in Capture, choose the list and custom fields, then install the generated loader snippet:

<script async src="https://listmint.us/embed/embed_homepage.js" data-mount="#listmint-form"></script>

Allowed origins are enforced before the iframe or loader will render, so configure every production origin you expect to serve the form from.

Operational dashboards

The current app surface is organized by responsibility:

Audience: lists, subscribers, consent state, suppression state, and custom-field values.
Capture: embed-form CRUD and install snippets.
Reports: subscriber growth, send outcomes, bounce rate, complaint rate, and usage summaries.
Admin → Inbox: public waitlist and inquiry feeds with review states.
Developer: service applications, API keys, and contract links.