API Keys

Connect your own systems to Mimeeq securely. Learn what the Embed and Admin APIs do, how to create keys and how to monitor API requests.

Mimeeq gives you two ways to connect your own systems to your Mimeeq account: the Embed API and the Admin API. This article explains what each one does, how to generate and manage the keys that authenticate them, and what happens to any key you're already using. You'll find everything described here under Settings → Customer settings → API Management.

For endpoint-level technical details, see our developer documentation.

---

Embed API and Admin API

#	API	What it does	When to use it
1	Embed API	Powers your customer-facing configurator experience. It handles product listings, configuration details, pricing and short codes — the things your website or storefront needs to show a configured product and its price.	If you already have an integration built with Mimeeq, it almost certainly uses this API.
2	Admin API	Newer, and for managing your account and catalogue data from your own systems: companies, contacts, products, quotations, carts, price lists, option sets and similar setup data.	When you want to sync Mimeeq with an ERP, CRM, e-commerce platform or internal tool — for example, pushing quotations into your order system or keeping company records in sync.

Admin API Keys and Embed API Keys sections under API Management in Mimeeq

In short: Embed API is about serving configured products to your customers; Admin API is about managing the account and catalogue behind the scenes.

---

Creating an Admin API key

1

Open API Keys

Go to Settings → Customer settings → API Management → API Keys.

2

Create a new key

In the Admin API Keys section, click + Create Admin Key.

3

Name the key

Give the key a name (required) and, optionally, a description and an expiry date.

4

Select scopes

Under Select Scopes, choose only the resources your integration actually needs (for example, just Companies and Contacts), or check All scopes if the integration needs full access.

5

Create the key

Click Create.

Create Admin Key form with name, description, expiry date and scope selection

Your new key is shown exactly once, in full, right after creation. Copy it and store it somewhere safe — Mimeeq will not display it again. If you lose it, you'll need to create a new key rather than retrieve the old one.

We recommend scoping keys narrowly and giving each integration its own key, so you can tell them apart in the requests log and revoke one without affecting the others.

---

What about the key I already have?

If you've been using Mimeeq's API before today, you have an Embed API key — it now lives under API Management → API Keys → Embed API Keys, listed as your Legacy Embed Key (or similarly named). This is simply a new home for it in the interface:

• The key's value hasn't changed.

• Your existing integration keeps working exactly as before.

• You don't need to do anything unless you want to.

The only time this key changes is if you choose to regenerate it — in which case the old value stops working immediately, and any integration using it will need to be updated with the new one.

This key is separate from the new Admin API keys described above. You don't need an Embed API key to create an Admin API key, or vice versa, since they authenticate two different APIs.

Legacy Embed Key listed under Embed API Keys

---

Keeping an eye on your API activity

The Requests Log tab (next to API Keys) shows the calls made with your keys over the last 30 days: timestamp, method, endpoint, status code, which key was used, and response time. Click any row to see full details, including whether the request was authorised, which scope it required, and — for failed requests — the exact error returned.

This is the fastest way to check why an integration isn't working. A 403 with a scope-related error usually means the key wasn't granted the permission the endpoint requires; going back into API Keys and adding that scope (or creating a new key with it) resolves it.

---

Where to go next

For request and response formats, authentication headers, available endpoints, scopes, pagination and error codes, see the full developer documentation:

• Admin API introduction

• Admin API reference

• Admin API conventions

• Authorisation guide

• Embed API reference

• Working with request logs

• Migrating between API key types

If you're not sure which API or scopes your integration needs, your developer or integration partner can check the reference docs above, or you can reach out to our support team.

---

Related articles

Webhooks

Send real-time Mimeeq event data to your own systems.

Events & Tracking

Use configurator events to feed your own analytics.

Custom UI

Build and deploy your own interface around the Mimeeq 3D configurator.