> For the complete documentation index, see [llms.txt](https://docs.getmesa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getmesa.com/connect/ipdetective.md).

# IPDetective

## Connection <a href="#connect" id="connect"></a>

When you're setting up your first workflow with IPDetective, you will need to locate your IPDetective API Key.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-28c7f2db0262b5b8eef1429c16b850d333d4e6ac%2Fimage%20(453).png?alt=media" alt="Screenshot of the MESA workflow builder IPDetective step connection setup, entering the IPDetective API Key. Spotlight the API Key field."><figcaption></figcaption></figure>

To get started, login into your account: <https://ipdetective.io/account>

Under the My API key heading, click on COPY next to your API Key.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-b8e52531006ef0b222471d9b5db3d39242222106%2FAS-IPD-COPYKEY.png?alt=media" alt="Screenshot of the IPDetective account page under the My API key heading, click COPY next to your API Key. Spotlight the COPY button."><figcaption></figcaption></figure>

Lastly, click on Add Connection and then you are all set! MESA is now connected with IPDetective.

### Configure <a href="#configuring" id="configuring"></a>

#### How to tell if an IP address is most likely a bot or <a href="#bot" id="bot"></a>

When you select configure to enter an Ip Address into the Retrieve IP Address step, IPDetective will tell you whether the IP address is most likely a bot or not.

![Screenshot of the MESA IPDetective Retrieve IP Address step Configure, entering an IP Address to check. Spotlight the IP Address field.](https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-b629102e7ed98dbf7ef068e7a6914221835f1521%2FAS-IPD-CONFIGURE.png?alt=media)

When the workflow runs and if you see Bot: true in the Activity tab, then the IP Address is most likely a bot.

If you see Bot: false, then the. IP Address is most likely not a bot.

![Screenshot of the MESA Activity tab showing the IPDetective result Bot true or Bot false for the checked IP Address. Spotlight the Bot value.](https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-d423b13d44361bcd85fa0e6149c8e688361c8904%2FAS-IPD-BOT.png?alt=media)
