> 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%2FO43lNH313oUsdKWxQRSm%2Fimage.png?alt=media&amp;token=e4a8cfa8-160e-4e83-94ff-0956f8661db9" 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%2FS8WFxvW1AsIrnxhe3dgd%2FAS-IPD-COPYKEY.png?alt=media&amp;token=5b6eb03a-bfb3-414f-a521-b542fe632c15" 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%2FMkT9H5dDLE51RxKrcjEd%2FAS-IPD-CONFIGURE.png?alt=media\&token=536b148c-9767-4023-aba0-0655c80aad78)

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%2FaS2KP8IyUH07ev13mPPj%2FAS-IPD-BOT.png?alt=media\&token=e58d6070-b7ab-4481-8d19-d50a9a6ef825)