@linkpane/newsletter-subscribe

Subscribe-only SDK for Linkpane Newsletter endpoints. Use this to add email subscribers without building your own newsletter backend.

Linkpane Mailer is a hosted form and email capture service by Haqqman. It allows you to collect form submissions and newsletter signups without building, deploying, or maintaining your own backend.

Install

npm install @linkpane/newsletter-subscribe

Usage

import { subscribeNewsletter } from '@linkpane/newsletter-subscribe'

const result = await subscribeNewsletter({
  apiBaseUrl: 'https://api.linkpane.com',
  username: 'my-newsletter',
  data: {
    email: '[email protected]',
    firstName: 'Ada',
    lastName: 'Lovelace'
  }
})

if (!result.ok) {
  console.error(result.message, result.errors)
}

Notes

Required Fields

Required fields depend on your Linkpane Newsletter configuration. Most setups require:

• email

Common optional fields:

• firstName
• lastName

Origin Rules

For browser usage, ensure the request Origin matches the configured source domain. For server-side usage, you must set an Origin header that matches the configured source domain.

Server Usage

You can supply a custom fetch for server environments.