@msgmorph/better-auth-plugin

Better Auth plugin for MsgMorph. Automatically creates contacts when users sign up.

Installation

npm install @msgmorph/better-auth-plugin

Setup

Add the plugin to your Better Auth configuration:

// auth.ts
import { betterAuth } from "better-auth";
import { msgMorphPlugin } from "@msgmorph/better-auth-plugin";

export const auth = betterAuth({
  // ... your config
  plugins: [
    msgMorphPlugin({
      apiKey: process.env.MSGMORPH_API_KEY!,
      organizationId: process.env.MSGMORPH_ORGANIZATION_ID!,
      projectId: process.env.MSGMORPH_PROJECT_ID!,
    }),
  ],
});

Configuration

| Option | Type | Required | Description | | ---------------- | -------- | -------- | -------------------------------- | | apiKey | string | Yes | Your MsgMorph API key | | organizationId | string | Yes | Your MsgMorph organization ID | | projectId | string | Yes | Project ID to create contacts in |

Environment Variables

MSGMORPH_API_KEY=your-api-key
MSGMORPH_ORGANIZATION_ID=your-org-id
MSGMORPH_PROJECT_ID=your-project-id

How It Works

The plugin hooks into Better Auth's signup flow:

1. User signs up via email or OAuth
2. After successful signup, plugin creates a contact in MsgMorph
3. Contact is linked via externalId (user's auth ID)

Documentation

For more docs, check docs.msgmorph.com.

License

MIT