Developers

Marsh API

Power your apps with Marshmallow integrations.

Go to Customer Portal Request License Access

Start with Marsh Editor

POST https://mrshtech.com/v1/marsh-editor/session

Use one active API key for your account and one Marsh Editor License Key for the editor feature.

MarshEditor.boot({
  apiKey: 'mt_live_your_api_key',
  licenseKey: 'MEDIT-MARSH-EDITOR-your_license_key',
  selector: 'textarea'
});

What is Marsh API?

Marsh API connects your customer account to licensed Marshmallow products. The API Key identifies the customer account, while the License Key activates a specific product feature such as Marsh Editor.

Secure authorization

Use Bearer tokens to authorize requests and protect your account.

One active API key

Only one active API key is allowed per customer account to simplify access management.

Marsh Editor ready

Attach the editor to any textarea after the license is active.

Expiry protected

Expired Marsh Editor licenses are disabled automatically and renewal is requested.

How it works

Create a customer account in the customer portal.
Buy a product or request Marsh Editor. Marsh Editor can be activated even without another product purchase.
Request License Key; after admin approval and payment, the key is generated and activated.
Request API access and generate one active API Key for the customer account.
Use API Key + License Key to attach Marsh Editor to textarea fields.

API vs License Key

License Key is unique per product or feature. Marsh Editor uses its own license and expiry date.
API Key is unique per customer account and can serve multiple licensed products.
Expired License Key disables Marsh Editor until a renewal request is approved.

Real example usage

Use this after the admin has activated your Marsh Editor License Key. The script looks for all textarea fields and attaches the editor only when the license is active.

JavaScript

MarshEditor.boot({
  apiKey: 'mt_live_your_api_key',
  licenseKey: 'MEDIT-MARSH-EDITOR-your_license_key',
  endpoint: 'https://mrshtech.com/v1/marsh-editor/session',
  selector: 'textarea',
  requestUrl: '/customer-portal.php?tab=portal-request-license',
  expiredMessage: 'Your Marsh Editor License Key has expired.',
  renewalMessage: 'Request new activation?'
}).then((session) => {
  console.log('Marsh Editor status:', session.status);
});

Try Marsh Editor

Test the editor UI here before connecting your own product. This demo attaches Marsh Editor to the textarea exactly like the licensed setup.

Example response

{
  "status": "success",
  "data": [
    {
      "id": 101,
      "type": "content",
      "product": "MARSH-EDITOR",
      "license": "active",
      "expires_at": "2027-06-24 23:59:59",
      "toolbar": ["bold", "italic", "link", "format"]
    }
  ],
  "meta": {
    "limit": 10,
    "count": 1
  }
}

If the license is expired, the admin panel sync marks Marsh Editor inactive and the API returns an expired status so your UI can show the renewal dialog.

Services

Categories