For your website

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 at dmaconnects.comAllowed embed domains: dermatologymanagersassociation.org, www.dermatologymanagersassociation.orgAPI version 2026-09-01

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.

  1. Link to https://dmaconnects.com/login with a next parameter for the portal page to land on.
  2. DMA Connect signs them in (an emailed link, a passkey or a password) and keeps the session on its own domain.
  3. 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/verify from the website's server.
Plain HTML link
<!-- 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>
Next.js component
// 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.

embed.js
<!-- 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.

/embed/events
<iframe
  src="https://dmaconnects.com/embed/events"
  title="Upcoming DMA events"
  width="100%"
  height="520"
  style="border:0;border-radius:12px"
  loading="lazy"
></iframe>
/embed/join
<iframe
  src="https://dmaconnects.com/embed/join"
  title="Join DMA"
  width="100%"
  height="420"
  style="border:0;border-radius:12px"
  loading="lazy"
></iframe>
Live preview: /embed/eventsOpen
Live preview: /embed/joinOpen

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
// 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.

MethodPathReturnsAuth
GET/api/v1/eventsPublished 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-typesActive 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/pingThe 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.

GET/api/v1/events
Request
curl https://dmaconnects.com/api/v1/events
Response
{
  "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 }
}
GET/api/v1/events/[slug]
Request
curl https://dmaconnects.com/api/v1/events/2027-annual-conference
Response
{
  "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"] }
    ]
  }
}
GET/api/v1/membership-types
Request
curl https://dmaconnects.com/api/v1/membership-types
Response
{
  "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 }
}
POST/api/v1/members/verify
Request
curl -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" }'
Response
{
  "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. ..." } }
GET/api/v1/ping
Request
curl https://dmaconnects.com/api/v1/ping \
  -H "Authorization: Bearer dma_pk_live_..."
Response
{
  "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=60

Webhooks

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.

EventWhen it firesPayload data
member.approvedA membership application was approved and the member went live.memberId
member.renewedDues were paid and the expiry date moved forward, including auto-renewals.memberId, endsOn
member.lapsedA grace period ended without payment.memberId
member.updatedA member changed their profile, practice or contact details.memberId
application.submittedSomeone submitted the membership application form.memberId, applicationId
registration.createdSomeone registered for an event, member or guest, paid or free.registrationId, eventId, memberId (empty for guests), email
registration.cancelledA registration was cancelled.registrationId, eventId, memberId
registration.checked_inAn attendee was admitted at check-in.registrationId, eventId, memberId
invoice.paidAny invoice was settled: dues, event tickets or sponsorships.invoiceId, kind
event.publishedAn event became visible on the public site.eventId, slug, name, startsOn
Example delivery
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"
  }
}
Verify the signature on the website
// 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.

Pick an endpoint and send a request. The response comes from this app's API.

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.

#12385e#149c8c#c9862b#0b2540#e6f5f2