Plug DMA Connect into the new Next.js site
Written for the developer building dermatologymanagersassociation.org. The website stays the front door; DMA Connect is the system of record behind it. Four integration points cover everything MemberClicks does today with its website builder, without locking the site into the platform.
Hosted login
The website never handles passwords. A Sign in link sends the visitor to the hosted login page and DMA Connect sends them back to where they were going.
- Link to
https://dmaconnects.com/loginwith anextparameter for the portal page to land on. - DMA Connect signs them in (an emailed link, a passkey or a password) and keeps the session on its own domain.
- The website can't see who is signed in here: DMA Connect runs on its own domain, so the two don't share a sign-in. To check whether an email address belongs to a current member (on a website form, say), call
POST /api/v1/members/verifyfrom the website's server.
<!-- Anywhere on the marketing site -->
<a href="https://dmaconnects.com/login?next=/portal">Member sign in</a>
<!-- Deep link straight to a portal page after login -->
<a href="https://dmaconnects.com/login?next=/portal/registrations">My registrations</a>// app/components/member-button.tsx (on the website)
import Link from "next/link";
const CONNECT = process.env.NEXT_PUBLIC_DMA_CONNECT_URL; // https://dmaconnects.com
export function MemberButton({ next = "/portal" }: { next?: string }) {
return (
<Link href={`${CONNECT}/login?next=${encodeURIComponent(next)}`} className="btn btn-primary">
Member sign in
</Link>
);
}Embeddable widgets
Two drop-in widgets cover the pages the website needs most: an upcoming events list and the join form. Both read live data, inherit DMA branding and open the full flow in a new tab.
Option A: script tag (recommended)
Mounts the widget in every element with a data-dma-widget attribute (events or join). One script tag serves the whole page.
<!-- 1. Drop a container where the widget should render -->
<div data-dma-widget="events"></div>
<!-- The join form works the same way; data-height overrides the height -->
<div data-dma-widget="join" data-height="800"></div>
<!-- 2. Load the embed script once, before </body> -->
<script async src="https://dmaconnects.com/embed.js"></script>Option B: iframe
Zero JavaScript on the host page. Works in any CMS block that accepts raw HTML.
<iframe
src="https://dmaconnects.com/embed/events"
title="Upcoming DMA events"
width="100%"
height="520"
style="border:0;border-radius:12px"
loading="lazy"
></iframe><iframe
src="https://dmaconnects.com/embed/join"
title="Join DMA"
width="100%"
height="420"
style="border:0;border-radius:12px"
loading="lazy"
></iframe>Prefer to own the markup? Render the events page as a server component on the website and call the API directly. Cached for five minutes with Next.js revalidate.
// app/events/page.tsx (on the website): server component, no client JS needed
export default async function EventsPage() {
// The key is optional for public data; with it the site gets its own rate limit.
const res = await fetch("https://dmaconnects.com/api/v1/events", {
headers: { Authorization: `Bearer ${process.env.DMA_PUBLIC_KEY}` },
next: { revalidate: 300 },
});
const { data } = await res.json();
return (
<ul>
{data.map((ev) => (
<li key={ev.id}>
<a href={ev.url}>{ev.name}</a> · {ev.startsOn}
{ev.ticketSummary.memberFrom !== null && <> · members from ${ev.ticketSummary.memberFrom}</>}
</li>
))}
</ul>
);
}REST API reference
Read-only JSON over HTTPS. Public endpoints work without a key; send a publishable key to get your own rate limit. Member verification needs a server key with the members scope. Staff create and revoke keys under Admin, Website integration; a key is shown once. All responses include permissive CORS headers so they can be called from the browser as well as the server.
| Method | Path | Returns | Auth |
|---|---|---|---|
| GET | /api/v1/events | Published public events, upcoming first. Filters: kind, upcoming=false, limit. | Optional key |
| GET | /api/v1/events/[slug] | One event with tickets, agenda, speakers, sponsors and hotel info. 404 JSON if missing. | Optional key |
| GET | /api/v1/membership-types | Active membership levels with price, term, benefits and a join URL. | Optional key |
| POST | /api/v1/members/verify | { member, status, memberNumber?, expiresOn?, membershipTypeId? } for an email. No other personal data. | Server key (members) |
| GET | /api/v1/ping | The key's name and scopes and the rate limit. Use it to check a key works. | Any key |
Send keys as Authorization: Bearer <key> or X-DMA-Api-Key. A missing or revoked key returns 401, a key without the scope 403. Unsupported methods return 405 with an Allow header. Errors use { "error": { "code", "message" } }. Rate limit: 60 requests a minute per key and visitor IP, or per IP without a key; every response carries X-RateLimit-Limit, X-RateLimit-Window and RateLimit-Policy, and a 429 carries Retry-After.
/api/v1/eventscurl https://dmaconnects.com/api/v1/events{
"data": [
{
"id": "ev_webinar_oct",
"slug": "manager-roundtable-2027-fee-schedule",
"name": "Manager Roundtable: 2027 Fee Schedule & Coding Updates",
"tagline": "What the proposed 2027 physician fee schedule means for dermatology reimbursement.",
"kind": "webinar",
"status": "published",
"startsOn": "2026-10-14",
"endsOn": "2026-10-14",
"timezone": "America/New_York",
"venueName": null,
"venueCity": null,
"isVirtual": true,
"ceuCredits": 1,
"capacity": 500,
"registration": { "open": true, "opensOn": "2026-09-10", "closesOn": "2026-10-14" },
"ticketSummary": { "count": 2, "memberFrom": 0, "nonMemberFrom": 49, "earlyBirdEndsOn": null, "currency": "USD" },
"url": "https://dmaconnects.com/events/manager-roundtable-2027-fee-schedule",
"registrationUrl": "https://dmaconnects.com/events/manager-roundtable-2027-fee-schedule/register"
},
{
"id": "ev_webinar_nov",
"slug": "year-end-hr-compliance-checklist",
"name": "Q4 Roundtable: Year-End HR & Compliance Checklist",
"kind": "webinar",
"startsOn": "2026-11-12",
"endsOn": "2026-11-12",
"isVirtual": true,
"ceuCredits": 1,
"registration": { "open": false, "opensOn": "2026-10-01", "closesOn": "2026-11-12" },
"ticketSummary": { "count": 2, "memberFrom": 0, "nonMemberFrom": 49, "earlyBirdEndsOn": null, "currency": "USD" },
"registrationUrl": "https://dmaconnects.com/events/year-end-hr-compliance-checklist/register"
},
{
"id": "ev_workshop_dec",
"slug": "aesthetic-marketing-workshop",
"name": "Aesthetic Marketing Workshop",
"kind": "workshop",
"startsOn": "2026-12-03",
"endsOn": "2026-12-03",
"isVirtual": true,
"ceuCredits": 3,
"registration": { "open": false, "opensOn": "2026-10-15", "closesOn": "2026-12-01" },
"ticketSummary": { "count": 2, "memberFrom": 79, "nonMemberFrom": 129, "earlyBirdEndsOn": null, "currency": "USD" },
"registrationUrl": "https://dmaconnects.com/events/aesthetic-marketing-workshop/register"
},
{
"id": "ev_conf_2027",
"slug": "2027-annual-conference",
"name": "2027 DMA Annual Conference",
"kind": "conference",
"startsOn": "2027-04-16",
"endsOn": "2027-04-17",
"venueName": "The Hotel at Avalon, Autograph Collection",
"venueCity": "Alpharetta, GA",
"isVirtual": false,
"ceuCredits": 12,
"capacity": 320,
"registration": { "open": true, "opensOn": "2026-09-15", "closesOn": "2027-04-10" },
"ticketSummary": { "count": 6, "memberFrom": 195, "nonMemberFrom": 355, "earlyBirdEndsOn": "2027-02-15", "currency": "USD" },
"registrationUrl": "https://dmaconnects.com/events/2027-annual-conference/register"
}
],
"meta": { "count": 4, "asOf": "2026-09-29", "upcomingOnly": true }
}/api/v1/events/[slug]curl https://dmaconnects.com/api/v1/events/2027-annual-conference{
"data": {
"id": "ev_conf_2027",
"slug": "2027-annual-conference",
"name": "2027 DMA Annual Conference",
"tagline": "Transforming the landscape of education and networking for dermatology and aesthetic practice teams.",
"kind": "conference",
"status": "published",
"startsOn": "2027-04-16",
"endsOn": "2027-04-17",
"timezone": "America/New_York",
"venueName": "The Hotel at Avalon, Autograph Collection",
"venueCity": "Alpharetta, GA",
"isVirtual": false,
"ceuCredits": 12,
"capacity": 320,
"registration": { "open": true, "opensOn": "2026-09-15", "closesOn": "2027-04-10" },
"ticketSummary": { "count": 6, "memberFrom": 195, "nonMemberFrom": 355, "earlyBirdEndsOn": "2027-02-15", "currency": "USD" },
"url": "https://dmaconnects.com/events/2027-annual-conference",
"registrationUrl": "https://dmaconnects.com/events/2027-annual-conference/register",
"description": "Two days of practical education for the people who run dermatology, plastic surgery and medical aesthetic practices. ...",
"heroColor": "#12385e",
"tracks": ["Managers", "Aesthetic", "Front & Back Office"],
"venueAddress": { "line1": "9000 Avalon Blvd", "city": "Alpharetta", "state": "GA", "zip": "30009" },
"hotelInfo": "A discounted room block at The Hotel at Avalon is available until March 20, 2027 at $219/night. Use group code DMA27 when booking.",
"tickets": [
{ "id": "tt_2027_mgr_member", "name": "Managers Track - Member", "description": "Friday and Saturday sessions, meals and reception.", "memberOnly": true, "track": "Managers", "price": 345, "earlyBird": true, "listPrice": 395, "earlyBirdEndsOn": "2027-02-15", "capacity": 180 },
{ "id": "tt_2027_mgr_nonmember", "name": "Managers Track - Non-member", "description": "Friday and Saturday sessions, meals and reception.", "memberOnly": false, "track": "Managers", "price": 495, "earlyBird": true, "listPrice": 545, "earlyBirdEndsOn": "2027-02-15", "capacity": 60 }
],
"sessions": [
{ "id": "s27_1", "title": "Welcome & State of the Association", "description": null, "track": "General", "day": "2027-04-16", "startTime": "08:30", "endTime": "09:00", "room": "Avalon Ballroom", "ceuCredits": 0, "speakers": ["Grant Kim"] },
{ "id": "s27_2", "title": "Mastering Insurance Denials & the Appeals Process, 2027 Edition", "description": "Denial trends, payer-specific appeal strategies and the KPIs a manager should review weekly.", "track": "Managers", "day": "2027-04-16", "startTime": "09:00", "endTime": "10:15", "room": "Avalon Ballroom A", "ceuCredits": 1.25, "speakers": ["Kendra Wallace, CPC"] }
],
"speakers": [{ "id": "sp_2", "name": "Kendra Wallace, CPC", "title": "Revenue Cycle Consultant", "company": "ClearClaim Consulting" }],
"sponsors": [{ "id": "sponsor_galderma", "name": "Galderma", "tier": "Platinum", "website": "https://www.galderma.com", "category": "Pharma", "boothNumber": "1" }],
"customQuestions": [
{ "id": "q_role", "label": "Primary role", "type": "select", "required": true, "options": ["Administrator / Practice Manager", "Office Manager", "Billing / Insurance", "Aesthetic staff", "Provider", "Vendor"] },
{ "id": "q_first", "label": "Is this your first DMA conference?", "type": "radio", "required": true, "options": ["Yes", "No"] }
]
}
}/api/v1/membership-typescurl https://dmaconnects.com/api/v1/membership-types{
"data": [
{
"id": "mt_manager",
"slug": "manager",
"name": "Manager Membership",
"description": "For administrators, practice managers and key personnel with direct management responsibility in a dermatology, plastic surgery or medical aesthetic practice.",
"price": 150,
"currency": "USD",
"term": "annual",
"gracePeriodDays": 30,
"autoRenewDefault": true,
"maxSeats": null,
"benefits": [
"Discounted registration to the DMA Annual Conference",
"Member-only resource library and conference recordings",
"Access to the DMA member directory and community forum",
"Monthly manager roundtable webinars with CEUs",
"Job board posting and resume bank",
"Salary and benchmark survey results"
],
"joinUrl": "https://dmaconnects.com/join?type=manager"
},
{ "id": "mt_practice", "slug": "practice", "name": "Practice Membership", "price": 425, "term": "annual", "maxSeats": 5, "joinUrl": "https://dmaconnects.com/join?type=practice" },
{ "id": "mt_aesthetic", "slug": "aesthetic", "name": "Aesthetic Staff Membership", "price": 95, "term": "annual", "maxSeats": null, "joinUrl": "https://dmaconnects.com/join?type=aesthetic" },
{ "id": "mt_partner", "slug": "industry-partner", "name": "Industry Partner", "price": 650, "term": "annual", "maxSeats": null, "joinUrl": "https://dmaconnects.com/join?type=industry-partner" }
],
"meta": { "count": 4 }
}/api/v1/members/verifycurl -X POST https://dmaconnects.com/api/v1/members/verify \
-H "Content-Type: application/json" \
-H "Authorization: Bearer dma_sk_live_..." \
-d '{ "email": "melissa.carter@peachtreederm.com" }'{
"member": true,
"status": "active",
"memberNumber": "DMA-2019-0135",
"expiresOn": "2027-03-15",
"membershipTypeId": "mt_practice"
}
// Unknown email
{ "member": false, "status": "not-found" }
// No key, or a key without the members scope
{ "error": { "code": "missing_api_key", "message": "Send an API key as Authorization: Bearer <key> or X-DMA-Api-Key. ..." } }/api/v1/pingcurl https://dmaconnects.com/api/v1/ping \
-H "Authorization: Bearer dma_pk_live_..."{
"ok": true,
"now": "2026-10-02T14:12:08.000Z",
"version": "2026-09-01",
"key": { "id": "key_01j9q0x8k2", "name": "Public website", "prefix": "dma_pk_live_7f3a", "scopes": ["read"] },
"rateLimit": { "limit": 60, "windowSeconds": 60 }
}
// Every response carries the policy:
// X-RateLimit-Limit: 60
// X-RateLimit-Window: 60
// RateLimit-Policy: 60;w=60Webhooks
DMA Connect posts a signed JSON event to each endpoint subscribed to it whenever something the site cares about changes. Anything but a 2xx response is retried with backoff, six attempts over about eleven hours. Staff add endpoints, pick events, send test events and read the delivery log under Admin, Website integration.
| Event | When it fires | Payload data |
|---|---|---|
member.approved | A membership application was approved and the member went live. | memberId |
member.renewed | Dues were paid and the expiry date moved forward, including auto-renewals. | memberId, endsOn |
member.lapsed | A grace period ended without payment. | memberId |
member.updated | A member changed their profile, practice or contact details. | memberId |
application.submitted | Someone submitted the membership application form. | memberId, applicationId |
registration.created | Someone registered for an event, member or guest, paid or free. | registrationId, eventId, memberId (empty for guests), email |
registration.cancelled | A registration was cancelled. | registrationId, eventId, memberId |
registration.checked_in | An attendee was admitted at check-in. | registrationId, eventId, memberId |
invoice.paid | Any invoice was settled: dues, event tickets or sponsorships. | invoiceId, kind |
event.published | An event became visible on the public site. | eventId, slug, name, startsOn |
POST https://www.dermatologymanagersassociation.org/api/dma-webhook
Content-Type: application/json
User-Agent: DMA-Connect-Webhooks/1.0
X-DMA-Event: registration.created
X-DMA-Delivery: whd_01j9q0x8k2m4
X-DMA-Signature: t=1759152000,v1=5f1e0a6c... (HMAC-SHA256 of "<t>.<raw body>" with your signing secret)
{
"id": "whd_01j9q0x8k2m4",
"type": "registration.created",
"createdAt": "2026-09-29T14:12:08.000Z",
"data": {
"registrationId": "reg_01j9q0x8",
"eventId": "ev_conf_2027",
"memberId": "m_001",
"email": "melissa.carter@peachtreederm.com"
}
}// app/api/dma-webhook/route.ts (on the website)
import { createHmac, timingSafeEqual } from "node:crypto";
export async function POST(req: Request) {
const raw = await req.text();
const header = req.headers.get("x-dma-signature") ?? "";
const parts = Object.fromEntries(header.split(",").map((p) => p.split("=") as [string, string]));
const t = Number(parts.t);
// Refuse old deliveries (more than five minutes) so a captured request cannot be replayed.
if (!t || Math.abs(Date.now() / 1000 - t) > 300) return new Response("stale", { status: 401 });
const expected = createHmac("sha256", process.env.DMA_WEBHOOK_SECRET!).update(`${t}.${raw}`).digest("hex");
const given = Buffer.from(parts.v1 ?? "");
if (given.length !== expected.length || !timingSafeEqual(given, Buffer.from(expected))) {
return new Response("bad signature", { status: 401 });
}
const event = JSON.parse(raw);
switch (event.type) {
case "member.approved": // add to the website newsletter list
case "member.renewed": // refresh cached member count on the home page
case "registration.created": // bump the "spots left" counter
case "invoice.paid": // sync to QuickBooks
}
return new Response("ok"); // any 2xx counts as delivered; anything else is retried
}Try it
These requests go to this app's API from your browser and return live data.
Staff create keys under Admin, Website integration. The key is only sent with these requests.
Shared branding
The portal, admin console, emails and widgets use the same design tokens as this page: navy #12385e, teal #149c8c, gold #c9862b, Inter for body text and Plus Jakarta Sans for headings. The website can import the same token file so a member never notices the seam between the two.