--- title: Mxtoolbox slug: connectors/mxtoolbox docTags: createdAt: 2026-06-09T16:29:51.743Z --- The MxToolbox connector integrates with Swimlane to lookup A, DNS, MX, PTR, SOA, SPF, and TXT records. Bundle will list MX records for a domain in priority order, lookup is done directly against the domain's authoritative name server, so changes to MX Records should show up instantly. ## Prerequisites The Connector requires an `API Key` to use the MxToolbox asset. You can get one [here](https://mxtoolbox.com/User/Api/Lookup.aspx) after creating an account. ## Capabilities The MxToolbox connector provides the following capabilities\:: - A Record Lookup - DNS Record Lookup - MX Record Lookup - PTR Record Lookup - SOA Record Lookup - SPF Record Lookup - TXT Record Lookup ## Notes - [MxToolbox REST API Documentation](https://mxtoolbox.com/User/Api/Lookup.aspx) # Configurations ## API Key Authentication Authenticates using an API Key ### Configuration Parameters | **Parameter** | **Description** | **Type** | **Required** | | ------------- | ---------------------------------- | -------- | ------------ | | url | A URL to the target host. | string | Required | | apikey | API key | string | Required | | verify\_ssl | Verify SSL certificate | boolean | Optional | | http\_proxy | A proxy to route requests through. | string | Optional | # Actions ## A Record Lookup A Record Lookup. ### Endpoint - **URL:** `/lookup/a/{{search_host}}/` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------------------- | -------- | ------------ | -------------------------------------- | | `path_parameters.search_host` | string | Required | Host where you want to do the lookups. | ### Input Example `{"path_parameters":{"search_host":"mxtoolbox.com"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------------- | -------- | --------------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `response` | object | Output field: response | | `response.Failed` | array | Output field: response.Failed | | `response.Failed.file_name` | string | Name of the resource | | `response.Failed.file` | string | Output field: response.Failed.file | | `response.Passed` | array | Output field: response.Passed | | `response.Passed.Name` | string | Name of the resource | | `response.Passed.Url` | string | URL endpoint for the request | | `response.Information` | array | Output field: response.Information | | `response.Information.Type` | string | Type of the resource | | `response.Information.Domain Name` | string | Name of the resource | | `response.Information.IP Address` | string | Output field: response.Information.IP Address | | `response.Information.TTL` | string | Output field: response.Information.TTL | | `response.Information.Asn` | string | Output field: response.Information.Asn | | `response.Information.IsIpV6` | string | Output field: response.Information.IsIpV6 | | `response.Transcript` | string | Output field: response.Transcript | | `response.UID` | object | Unique identifier | | `response.Command` | string | Output field: response.Command | | `response.IsTransitioned` | boolean | Output field: response.IsTransitioned | | `response.CommandArgument` | string | Output field: response.CommandArgument | | `response.TimeRecorded` | string | Output field: response.TimeRecorded | | `response.ReportingNameServer` | string | Name of the resource | | `response.TimeToComplete` | string | Output field: response.TimeToComplete | | `response.RelatedIP` | object | Output field: response.RelatedIP | ### Output Example `{"status_code":200,"response_headers":{"Content-Type":"application/json; charset=utf-8","Content-Length":"3392","Connection":"keep-alive","Vary":"Accept-Encoding","Date":"Mon, 20 Nov 2023 09:37:21 GMT","Cache-Control":"no-cache","Pragma":"no-cache","Expires":"-1","Server":"Microsoft-IIS/10.0","X-Powered-By":"UrlRewriter.NET 2.0.0, ASP.NET","Access-Control-Allow-Origin":"*","X-AspNet-Version":"4.0.30319","Access-Control-Allow-Credentials":"true","X-Cache":"Miss from cloudfront","Via":"1.1 94986b8...` ## DNS Record Lookup DNS Record Lookup ### Endpoint - **URL:** `/lookup/dns/{{search_host}}/` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------------------- | -------- | ------------ | ------------------------------------------- | | `path_parameters.search_host` | string | Required | Parameters for the DNS Record Lookup action | ### Input Example `{"path_parameters":{"search_host":"mxtoolbox.com"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------------- | -------- | --------------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `response` | object | Output field: response | | `response.Failed` | array | Output field: response.Failed | | `response.Failed.file_name` | string | Name of the resource | | `response.Failed.file` | string | Output field: response.Failed.file | | `response.Passed` | array | Output field: response.Passed | | `response.Passed.Name` | string | Name of the resource | | `response.Passed.Url` | string | URL endpoint for the request | | `response.Information` | array | Output field: response.Information | | `response.Information.Type` | string | Type of the resource | | `response.Information.Domain Name` | string | Name of the resource | | `response.Information.IP Address` | string | Output field: response.Information.IP Address | | `response.Information.TTL` | string | Output field: response.Information.TTL | | `response.Information.Status` | string | Status value | | `response.Information.Time (ms)` | string | Output field: response.Information.Time (ms) | | `response.Information.Auth` | string | Output field: response.Information.Auth | | `response.Information.Parent` | string | Output field: response.Information.Parent | | `response.Information.Local` | string | Output field: response.Information.Local | | `response.Information.Asn` | string | Output field: response.Information.Asn | | `response.Information.IsIpV6` | string | Output field: response.Information.IsIpV6 | | `response.Transcript` | string | Output field: response.Transcript | | `response.UID` | object | Unique identifier | | `response.Command` | string | Output field: response.Command | | `response.IsTransitioned` | boolean | Output field: response.IsTransitioned | ### Output Example `{"status_code":200,"response_headers":{"Content-Type":"application/json; charset=utf-8","Content-Length":"10370","Connection":"keep-alive","Vary":"Accept-Encoding","Date":"Mon, 20 Nov 2023 09:39:23 GMT","Cache-Control":"no-cache","Pragma":"no-cache","Expires":"-1","Server":"Microsoft-IIS/10.0","X-Powered-By":"UrlRewriter.NET 2.0.0, ASP.NET","Access-Control-Allow-Origin":"*","X-AspNet-Version":"4.0.30319","Access-Control-Allow-Credentials":"true","X-Cache":"Miss from cloudfront","Via":"1.1 d3e151...` ## MX Record Lookup Lookup MX Record. ### Endpoint - **URL:** `/lookup/mx/{{search_host}}/` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------------------- | -------- | ------------ | ------------------------------------------ | | `path_parameters.search_host` | string | Required | Parameters for the MX Record Lookup action | ### Input Example `{"path_parameters":{"search_host":"mxtoolbox.com"}}` ### Output | **Parameter** | **Type** | **Description** | | --------------------------------- | -------- | --------------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `response` | object | Output field: response | | `response.Failed` | array | Output field: response.Failed | | `response.Failed.file_name` | string | Name of the resource | | `response.Failed.file` | string | Output field: response.Failed.file | | `response.Passed` | array | Output field: response.Passed | | `response.Passed.Name` | string | Name of the resource | | `response.Passed.Url` | string | URL endpoint for the request | | `response.Information` | array | Output field: response.Information | | `response.Information.Pref` | string | Output field: response.Information.Pref | | `response.Information.Hostname` | string | Name of the resource | | `response.Information.IP Address` | string | Output field: response.Information.IP Address | | `response.Information.TTL` | string | Output field: response.Information.TTL | | `response.Information.Asn` | string | Output field: response.Information.Asn | | `response.Information.IsIpV6` | string | Output field: response.Information.IsIpV6 | | `response.Transcript` | string | Output field: response.Transcript | | `response.UID` | object | Unique identifier | | `response.Command` | string | Output field: response.Command | | `response.IsTransitioned` | boolean | Output field: response.IsTransitioned | | `response.CommandArgument` | string | Output field: response.CommandArgument | | `response.TimeRecorded` | string | Output field: response.TimeRecorded | | `response.ReportingNameServer` | string | Name of the resource | | `response.TimeToComplete` | string | Output field: response.TimeToComplete | | `response.RelatedIP` | object | Output field: response.RelatedIP | ### Output Example `{"status_code":200,"response_headers":{"Content-Type":"application/json; charset=utf-8","Content-Length":"3340","Connection":"keep-alive","Vary":"Accept-Encoding","Date":"Mon, 20 Nov 2023 09:41:45 GMT","Cache-Control":"no-cache","Pragma":"no-cache","Expires":"-1","Server":"Microsoft-IIS/10.0","X-Powered-By":"UrlRewriter.NET 2.0.0, ASP.NET","Access-Control-Allow-Origin":"*","X-AspNet-Version":"4.0.30319","Access-Control-Allow-Credentials":"true","X-Cache":"Miss from cloudfront","Via":"1.1 a78b605...` ## PTR Record Lookup Lookup PTR Record. ### Endpoint - **URL:** `/lookup/ptr/{{search_host}}/` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------------------- | -------- | ------------ | ------------------------------------------- | | `path_parameters.search_host` | string | Required | Parameters for the PTR Record Lookup action | ### Input Example `{"path_parameters":{"search_host":"8.8.8.8"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------------- | -------- | --------------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `response` | object | Output field: response | | `response.Failed` | array | Output field: response.Failed | | `response.Failed.file_name` | string | Name of the resource | | `response.Failed.file` | string | Output field: response.Failed.file | | `response.Passed` | array | Output field: response.Passed | | `response.Passed.Name` | string | Name of the resource | | `response.Passed.Url` | string | URL endpoint for the request | | `response.Information` | array | Output field: response.Information | | `response.Information.Type` | string | Type of the resource | | `response.Information.IP Address` | string | Output field: response.Information.IP Address | | `response.Information.Domain Name` | string | Name of the resource | | `response.Information.TTL` | string | Output field: response.Information.TTL | | `response.Information.Asn` | string | Output field: response.Information.Asn | | `response.Information.IsIpV6` | string | Output field: response.Information.IsIpV6 | | `response.Transcript` | string | Output field: response.Transcript | | `response.UID` | object | Unique identifier | | `response.Command` | string | Output field: response.Command | | `response.IsTransitioned` | boolean | Output field: response.IsTransitioned | | `response.CommandArgument` | string | Output field: response.CommandArgument | | `response.TimeRecorded` | string | Output field: response.TimeRecorded | | `response.ReportingNameServer` | string | Name of the resource | | `response.TimeToComplete` | string | Output field: response.TimeToComplete | | `response.RelatedIP` | string | Output field: response.RelatedIP | ### Output Example `{"status_code":200,"response_headers":{"Content-Type":"application/json; charset=utf-8","Content-Length":"3159","Connection":"keep-alive","Vary":"Accept-Encoding","Date":"Mon, 20 Nov 2023 09:43:58 GMT","Cache-Control":"no-cache","Pragma":"no-cache","Expires":"-1","Server":"Microsoft-IIS/10.0","X-Powered-By":"UrlRewriter.NET 2.0.0, ASP.NET","Access-Control-Allow-Origin":"*","X-AspNet-Version":"4.0.30319","Access-Control-Allow-Credentials":"true","X-Cache":"Miss from cloudfront","Via":"1.1 1702d8d...` ## SOA Record Lookup Lookup SOA Record. ### Endpoint - **URL:** `/lookup/soa/{{search_host}}/` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------------------- | -------- | ------------ | ------------------------------------------- | | `path_parameters.search_host` | string | Required | Parameters for the SOA Record Lookup action | ### Input Example `{"path_parameters":{"search_host":"google.com"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------------------- | -------- | ---------------------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `response` | object | Output field: response | | `response.Failed` | array | Output field: response.Failed | | `response.Failed.file_name` | string | Name of the resource | | `response.Failed.file` | string | Output field: response.Failed.file | | `response.Passed` | array | Output field: response.Passed | | `response.Passed.Name` | string | Name of the resource | | `response.Passed.Url` | string | URL endpoint for the request | | `response.Information` | array | Output field: response.Information | | `response.Information.Type` | string | Type of the resource | | `response.Information.Domain Name` | string | Name of the resource | | `response.Information.Primary NS` | string | Output field: response.Information.Primary NS | | `response.Information.Responsible Email` | string | Output field: response.Information.Responsible Email | | `response.Information.TTL` | string | Output field: response.Information.TTL | | `response.Transcript` | string | Output field: response.Transcript | | `response.UID` | object | Unique identifier | | `response.Command` | string | Output field: response.Command | | `response.IsTransitioned` | boolean | Output field: response.IsTransitioned | | `response.CommandArgument` | string | Output field: response.CommandArgument | | `response.TimeRecorded` | string | Output field: response.TimeRecorded | | `response.ReportingNameServer` | string | Name of the resource | | `response.TimeToComplete` | string | Output field: response.TimeToComplete | | `response.RelatedIP` | object | Output field: response.RelatedIP | | `response.IsEndpoint` | boolean | Output field: response.IsEndpoint | ### Output Example `{"status_code":200,"response_headers":{"Content-Type":"application/json; charset=utf-8","Content-Length":"2512","Connection":"keep-alive","Vary":"Accept-Encoding","Date":"Mon, 20 Nov 2023 09:45:50 GMT","Cache-Control":"no-cache","Pragma":"no-cache","Expires":"-1","Server":"Microsoft-IIS/10.0","X-Powered-By":"UrlRewriter.NET 2.0.0, ASP.NET","Access-Control-Allow-Origin":"*","X-AspNet-Version":"4.0.30319","Access-Control-Allow-Credentials":"true","X-Cache":"Miss from cloudfront","Via":"1.1 322b6bd...` ## SPF Record Lookup Lookup SPF Record. ### Endpoint - **URL:** `/lookup/spf/{{search_host}}/` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------------------- | -------- | ------------ | ------------------------------------------- | | `path_parameters.search_host` | string | Required | Parameters for the SPF Record Lookup action | ### Input Example `{"path_parameters":{"search_host":"mxtoolbox.com"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------------- | -------- | ---------------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `response` | object | Output field: response | | `response.Failed` | array | Output field: response.Failed | | `response.Failed.file_name` | string | Name of the resource | | `response.Failed.file` | string | Output field: response.Failed.file | | `response.Passed` | array | Output field: response.Passed | | `response.Passed.Name` | string | Name of the resource | | `response.Passed.Url` | string | URL endpoint for the request | | `response.Information` | array | Output field: response.Information | | `response.Information.Prefix` | string | Output field: response.Information.Prefix | | `response.Information.Type` | string | Type of the resource | | `response.Information.Value` | string | Value for the parameter | | `response.Information.PrefixDesc` | string | Output field: response.Information.PrefixDesc | | `response.Information.Description` | string | Output field: response.Information.Description | | `response.Information.RecordNum` | object | Output field: response.Information.RecordNum | | `response.Transcript` | string | Output field: response.Transcript | | `response.UID` | object | Unique identifier | | `response.Command` | string | Output field: response.Command | | `response.IsTransitioned` | boolean | Output field: response.IsTransitioned | | `response.CommandArgument` | string | Output field: response.CommandArgument | | `response.TimeRecorded` | string | Output field: response.TimeRecorded | | `response.ReportingNameServer` | string | Name of the resource | | `response.TimeToComplete` | string | Output field: response.TimeToComplete | | `response.RelatedIP` | object | Output field: response.RelatedIP | ### Output Example `{"status_code":200,"response_headers":{"Content-Type":"application/json; charset=utf-8","Content-Length":"8763","Connection":"keep-alive","Vary":"Accept-Encoding","Date":"Mon, 20 Nov 2023 09:48:39 GMT","Cache-Control":"no-cache","Pragma":"no-cache","Expires":"-1","Server":"Microsoft-IIS/10.0","X-Powered-By":"UrlRewriter.NET 2.0.0, ASP.NET","Access-Control-Allow-Origin":"*","X-AspNet-Version":"4.0.30319","Access-Control-Allow-Credentials":"true","X-Cache":"Miss from cloudfront","Via":"1.1 56114c6...` ## TXT Record Lookup Lookup TXT Record. ### Endpoint - **URL:** `/lookup/txt/{{search_host}}/` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------------------- | -------- | ------------ | ------------------------------------------- | | `path_parameters.search_host` | string | Required | Parameters for the TXT Record Lookup action | ### Input Example `{"path_parameters":{"search_host":"mxtoolbox.com"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------------- | -------- | ----------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `response` | object | Output field: response | | `response.Failed` | array | Output field: response.Failed | | `response.Failed.file_name` | string | Name of the resource | | `response.Failed.file` | string | Output field: response.Failed.file | | `response.Passed` | array | Output field: response.Passed | | `response.Passed.Name` | string | Name of the resource | | `response.Passed.Url` | string | URL endpoint for the request | | `response.Information` | array | Output field: response.Information | | `response.Information.Type` | string | Type of the resource | | `response.Information.Domain Name` | string | Name of the resource | | `response.Information.TTL` | string | Output field: response.Information.TTL | | `response.Information.Record` | string | Output field: response.Information.Record | | `response.Transcript` | string | Output field: response.Transcript | | `response.UID` | object | Unique identifier | | `response.Command` | string | Output field: response.Command | | `response.IsTransitioned` | boolean | Output field: response.IsTransitioned | | `response.CommandArgument` | string | Output field: response.CommandArgument | | `response.TimeRecorded` | string | Output field: response.TimeRecorded | | `response.ReportingNameServer` | string | Name of the resource | | `response.TimeToComplete` | string | Output field: response.TimeToComplete | | `response.RelatedIP` | object | Output field: response.RelatedIP | | `response.IsEndpoint` | boolean | Output field: response.IsEndpoint | | `response.HasSubscriptions` | boolean | Output field: response.HasSubscriptions | ### Output Example `{"status_code":200,"response_headers":{"Content-Type":"application/json; charset=utf-8","Content-Length":"3499","Connection":"keep-alive","Vary":"Accept-Encoding","Date":"Mon, 20 Nov 2023 09:50:25 GMT","Cache-Control":"no-cache","Pragma":"no-cache","Expires":"-1","Server":"Microsoft-IIS/10.0","X-Powered-By":"UrlRewriter.NET 2.0.0, ASP.NET","Access-Control-Allow-Origin":"*","X-AspNet-Version":"4.0.30319","Access-Control-Allow-Credentials":"true","X-Cache":"Miss from cloudfront","Via":"1.1 edf9d35...` # Response Headers | **Header** | **Description** | **Example** | | -------------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------------- | | Access-Control-Allow-Credentials | HTTP response header: Access-Control-Allow-Credentials | true | | Access-Control-Allow-Origin | HTTP response header: Access-Control-Allow-Origin | \* | | Cache-Control | Directives for caching mechanisms | no-cache | | Connection | HTTP response header: Connection | keep-alive | | Content-Length | The length of the response body in bytes | 8763 | | Content-Type | The media type of the resource | application/json; charset=utf-8 | | Date | The date and time at which the message was originated | Mon, 20 Nov 2023 09:37:21 GMT | | Expires | The date/time after which the response is considered stale | -1 | | Pragma | HTTP response header: Pragma | no-cache | | Server | Information about the software used by the origin server | Microsoft-IIS/10.0 | | Vary | HTTP response header: Vary | Accept-Encoding | | Via | HTTP response header: Via | 1.1 edf9d353e05a39e52d09ba01bac3000a.cloudfront.net (CloudFront) | | X-Amz-Cf-Id | HTTP response header: X-Amz-Cf-Id | GNX7z-6HsqJpFd-hFyVrExn\_WVU5rWwN91J1OljDtp9mSWTlC6MMtg== | | X-Amz-Cf-Pop | HTTP response header: X-Amz-Cf-Pop | BOM78-P8 | | X-AspNet-Version | HTTP response header: X-AspNet-Version | 4.0.30319 | | X-Cache | HTTP response header: X-Cache | Miss from cloudfront | | X-Powered-By | HTTP response header: X-Powered-By | UrlRewriter.NET 2.0.0, ASP.NET |