> For the complete documentation index, see [llms.txt](https://docs.gearplug.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gearplug.io/english/set-up-your-integrations/mailrelay/create-your-mailrelay-connection.md).

# Create your Mailrelay connection

{% hint style="info" %}
**Oauth connection**: The first step is to install GearPlug in your account so that GearPlug may access the data.
{% endhint %}

To create your Mailrelay Plug, you’ll need the URL and API Token. You can get these from your Mailrelay account, following the instructions below.

### Set up access

1. **Head over to “My Apps”** in the upper-right corner of your GearPlug interface.

<figure><img src="/files/zpGnqXFuNlmUENBhBcZw" alt=""><figcaption></figcaption></figure>

2. **Select Mailrelay** on the drop-down menu under “New connection” and click “Create.”

<figure><img src="/files/GlEttI6PGpUfOlkinZJ8" alt=""><figcaption></figcaption></figure>

3. **Switch into your Mailrelay dashboard and click “API keys”** on the drop-down menu to the left.

<figure><img src="/files/7HGR4Fnvleug2Ym6bF5Q" alt=""><figcaption></figcaption></figure>

4. **Click “+ Add.”** This will make you choose a user for the API token. Pick the user you want to use and click “Create API key.” Under “Token,” you’ll find the code you need.

<figure><img src="/files/mhitwLMELx2cKGNMTVDV" alt=""><figcaption></figcaption></figure>

5. **Copy your Mailrelay URL and the API** token you just generated. Paste them in the corresponding fields in your GearPlug dashboard and click “Continue.”

<figure><img src="/files/8ldqSPcIaEBjDpDr51ty" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
When copying your Mailrelay URL, you just need the name, extension, and “.com:” If you copy any other information, such as “https\://” or whatever comes after “.com,” the connection will trigger an error.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.gearplug.io/english/set-up-your-integrations/mailrelay/create-your-mailrelay-connection.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
