# Introduction

## URL

The Mailhub API is based on REST principles. HTTPS is enforced for every request to enhance data security, integrity, and privacy. The API does not support HTTP.

All requests use the following base URL:

```url
https://api.mailhub.sh
```

## Authentication

To authenticate, you need to include an Authorization header with the value `Bearer mh_xxxxxxxxxx`, where `mh_xxxxxxxxxx` is your API Key.

{% hint style="info" %}
Mailhub offers two types of authentication keys:

1. **Production keys:** These keys send emails as requested.
2. **Development keys:** When using a development key, HTTP requests will behave the same as in production, but the emails will not be sent to the recipients. Instead, they will only be available in your inbox.
   {% endhint %}

```url
Authorization: Bearer mh_123456789
```


---

# Agent Instructions: 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:

```
GET https://documentation.mailhub.sh/introduction.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.