---
title: MXTOOLBOX
slug: authentication-guides/mxtoolbox
docTags: 
createdAt: 2026-10-05T04:37:44.472Z
---

## Introduction

This guide tells you how to authenticate the **MxToolbox** connector in Swimlane using API Key Authentication.

You will obtain an API key from your MxToolbox account and configure the connector in Swimlane. The MxToolbox connector uses this API key to perform DNS and email-related lookups, including A, DNS, MX, PTR, SOA, SPF, and TXT record lookups.

## Prerequisites

### MxToolbox Access Requirements

You must have:

- An active MxToolbox account.
- Access to the API settings for the MxToolbox account.
- An MxToolbox API key.

The MxToolbox REST API authenticates requests using an API key. The API key is associated with your MxToolbox account.

### Required Credentials

During setup, you will collect:

- **URL**
- **API Key**

The Swimlane connector requires both url and apikey.

## MxToolbox Setup

### Obtain an API Key

Take the following steps to obtain the API key:

1. Log in to your MxToolbox account.
2. Click your username in the upper-right corner.
3. Click **Settings**.
4. Open the **API** tab.
5. Locate your API key. If an API key has not been generated for your account, follow the available option to obtain one.
6. Copy and securely save the API key. You will use this value as the apikey when configuring the connector in Swimlane.

MxToolbox states that API keys can also be revoked from the API page if a key is compromised or needs to be rotated. Once revoked, you must use a new API key for subsequent API requests.

### API URL

Use the MxToolbox API endpoint as the URL for the connector.

The current MxToolbox REST API documentation identifies the base URL as:

https\://api.mxtoolbox.com/api/v1/

MxToolbox requires authenticated API requests to include the API key in the Authorization header. The API key is passed directly and does not use a Bearer prefix. Swimlane handles this authentication when the API key is supplied in the connector asset.

## Connector configuration in Swimlane

1. Log in to Turbine.
2. From the left-hand navigation pane, click **ORCHESTRATION** and click **Assets**.
3. Asset homepage opens.
4. Click the plus icon to open the **Configure your Connector Asset** window.
5. Select **MxToolbox** from the **Asset type** list.
6. Fill in the **Asset Settings** and **Asset Input** as shown:

| **Field**   | **Description**                 | **Required/Optional** |
| ----------- | ------------------------------- | --------------------- |
| url         | URL to the MxToolbox API host   | Required              |
| apikey      | API key obtained from MxToolbox | Required              |
| verify\_ssl | Enable/Disable SSL Verification | Optional              |
| http\_proxy | Optional proxy configuration    | Optional              |

The Swimlane connector defines url and apikey as required fields, while verify\_ssl and http\_proxy are optional.

Fields with \* marks are required.

7. Click **Create**.

::Image[]{src="https://api.archbee.com/api/optimize/n8uUzk0MM4uC57-zlHNtY/fVhaj1YkVdke47m7li-zX_image.png" size="200" isUploading="false" width="2048" height="1037" darkWidth="2048" darkHeight="1037" showCaption="false"}

## Troubleshooting

If authentication fails:

- Verify that the API key entered in the apikey field is correct and has not been revoked.
- Verify that the MxToolbox API URL is correct.
- If you receive a **401 Unauthorized** response, verify that a valid API key is configured. MxToolbox documents HTTP 401 as the response for a missing or invalid API key.
- If requests fail because of usage limits, check the API usage associated with your MxToolbox plan. MxToolbox applies request quotas and rate limits to API usage.
- If you suspect that the API key has been compromised, revoke it from the MxToolbox API settings and use a new key in the Swimlane asset.

**Result:** You have successfully authenticated the MxToolbox Connector in Swimlane.

## Sources

The authentication procedure in this guide is based on the **official MxToolbox API documentation and knowledge base**, together with the connector configuration supplied for Swimlane.

- **MxToolbox RESTful API Reference**
  [MxToolbox RESTful API Reference](https://lookup.mxtoolbox.com/api/api-reference?utm_source=chatgpt.com)
- **MxToolbox - About API**
  [MxToolbox About API](https://knowledgebase.mxtoolbox.com/home/about-api?utm_source=chatgpt.com)
- **MxToolbox - API Methods**
  [MxToolbox API Methods](https://knowledgebase.mxtoolbox.com/home/api-methods?utm_source=chatgpt.com)