Introduction

Base URL: https://hidemail.app

This documentation aims to provide all the information you need to work with our API.

Authenticating requests

To authenticate requests, include an Authorization header with the value "Bearer {YOUR_AUTH_KEY}".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

You can retrieve your token by visiting your dashboard, find in menu API tokens and create a new one.

Endpoints

Create a token.

This endpoint lets you create a permanent token.

Example request:

curl --request POST \
    "https://hidemail.app/api/v1/sanctum/token" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"email\": \"[email protected]\",
    \"password\": \"password\",
    \"device_name\": \"Raycast\"
}"

const url = new URL(
    "https://hidemail.app/api/v1/sanctum/token"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "email": "[email protected]",
    "password": "password",
    "device_name": "Raycast"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$url = 'https://hidemail.app/api/v1/sanctum/token';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'email' => '[email protected]',
            'password' => 'password',
            'device_name' => 'Raycast',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

import requests
import json

url = 'https://hidemail.app/api/v1/sanctum/token'
payload = {
    "email": "[email protected]",
    "password": "password",
    "device_name": "Raycast"
}
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (422):

Show headers

cache-control: no-cache, private
content-type: application/json
x-ratelimit-limit: 10
x-ratelimit-remaining: 9
access-control-allow-origin: *


{
    "message": "The given data was invalid.",
    "errors": {
        "email": [
            "The provided credentials are incorrect."
        ]
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/v1/sanctum/token

Headers

Content-Type

Example: application/json

Accept

Example: application/json

Body Parameters

email string

Email. Example: [email protected]

password string

Password. Example: password

device_name string

Device Name. Example: Raycast

GET api/user

requires authentication

Example request:

curl --request GET \
    --get "https://hidemail.app/api/user" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

const url = new URL(
    "https://hidemail.app/api/user"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$url = 'https://hidemail.app/api/user';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

import requests
import json

url = 'https://hidemail.app/api/user'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (401):

Show headers

cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *


{
    "message": "Not authenticated"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

POST api/v1/email/create

requires authentication

Example request:

curl --request POST \
    "https://hidemail.app/api/v1/email/create" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

const url = new URL(
    "https://hidemail.app/api/v1/email/create"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$url = 'https://hidemail.app/api/v1/email/create';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

import requests
import json

url = 'https://hidemail.app/api/v1/email/create'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers)
response.json()

Example response (401):

Show headers

cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *


{
    "message": "Not authenticated"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

GET api/v1/domain-options

requires authentication

Example request:

curl --request GET \
    --get "https://hidemail.app/api/v1/domain-options" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

const url = new URL(
    "https://hidemail.app/api/v1/domain-options"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$url = 'https://hidemail.app/api/v1/domain-options';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

import requests
import json

url = 'https://hidemail.app/api/v1/domain-options'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (401):

Show headers

cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *


{
    "message": "Not authenticated"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Create a new email alias.

requires authentication

This endpoint lets you create a new alias.

Example request:

curl --request POST \
    "https://hidemail.app/api/v1/aliases" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"description\": \"My new alias\"
}"

const url = new URL(
    "https://hidemail.app/api/v1/aliases"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "description": "My new alias"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$url = 'https://hidemail.app/api/v1/aliases';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'description' => 'My new alias',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

import requests
import json

url = 'https://hidemail.app/api/v1/aliases'
payload = {
    "description": "My new alias"
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "data": {
        "email": "[email protected]",
        "note": "My shopping account",
        "is_active": true,
        "created_at": "2024-01-28T15:03:09.000000Z",
        "updated_at": "2024-01-28T15:03:09.000000Z",
        "total_forwarded": 0,
        "total_blocked": 0
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/v1/aliases

Headers

Authorization

Example: Bearer {YOUR_AUTH_KEY}

Content-Type

Example: application/json

Accept

Example: application/json

Body Parameters

description string optional

Note. Example: My new alias

Update an email alias note.

requires authentication

This endpoint allows you to update the note for a specific email alias.

Example request:

curl --request PATCH \
    "https://hidemail.app/api/v1/aliases" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"note\": \"\\\"My shopping account\\\"\",
    \"email\": \"[email protected]\"
}"

const url = new URL(
    "https://hidemail.app/api/v1/aliases"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "note": "\"My shopping account\"",
    "email": "[email protected]"
};

fetch(url, {
    method: "PATCH",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$url = 'https://hidemail.app/api/v1/aliases';
$response = $client->patch(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'note' => '"My shopping account"',
            'email' => '[email protected]',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

import requests
import json

url = 'https://hidemail.app/api/v1/aliases'
payload = {
    "note": "\"My shopping account\"",
    "email": "[email protected]"
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('PATCH', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "data": {
        "email": "[email protected]",
        "note": "My shopping account",
        "is_active": true,
        "created_at": "2024-01-28T15:03:09.000000Z",
        "updated_at": "2024-01-28T15:03:09.000000Z",
        "total_forwarded": 0,
        "total_blocked": 0
    }
}

Example response (404):


{
    "message": "Email alias not found"
}

Example response (422):


{
    "message": "The note field is required.",
    "errors": {
        "note": [
            "The note field is required."
        ]
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

PATCH api/v1/aliases

Headers

Authorization

Example: Bearer {YOUR_AUTH_KEY}

Content-Type

Example: application/json

Accept

Example: application/json

Body Parameters

note string

The new note for the alias. Max 255 characters. Example: "My shopping account"

email string

The email alias to update. Example: [email protected]

Get all aliases.

requires authentication

This endpoint lets you get all your aliases.

Example request:

curl --request GET \
    --get "https://hidemail.app/api/v1/aliases" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"page\": {
        \"number\": 38,
        \"size\": 86
    },
    \"search\": \"jmyuxpcpjtgwmqrequxgpvromuixcdqdmztilwaydcofwpnqilfoxolqrficpyyubxypqxfbritvkvcosucqbahey\",
    \"filter\": {
        \"is_active\": 90
    },
    \"sort\": \"vziwsmzsjwdpeasjozxsgcbmhpczdatxkjvduvfpijnuyinxdbucjwqgxlpzki\",
    \"page[size]\": 100,
    \"page[number]\": 1
}"

const url = new URL(
    "https://hidemail.app/api/v1/aliases"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "page": {
        "number": 38,
        "size": 86
    },
    "search": "jmyuxpcpjtgwmqrequxgpvromuixcdqdmztilwaydcofwpnqilfoxolqrficpyyubxypqxfbritvkvcosucqbahey",
    "filter": {
        "is_active": 90
    },
    "sort": "vziwsmzsjwdpeasjozxsgcbmhpczdatxkjvduvfpijnuyinxdbucjwqgxlpzki",
    "page[size]": 100,
    "page[number]": 1
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$url = 'https://hidemail.app/api/v1/aliases';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'page' => [
                'number' => 38,
                'size' => 86,
            ],
            'search' => 'jmyuxpcpjtgwmqrequxgpvromuixcdqdmztilwaydcofwpnqilfoxolqrficpyyubxypqxfbritvkvcosucqbahey',
            'filter' => [
                'is_active' => 90,
            ],
            'sort' => 'vziwsmzsjwdpeasjozxsgcbmhpczdatxkjvduvfpijnuyinxdbucjwqgxlpzki',
            'page[size]' => 100,
            'page[number]' => 1,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

import requests
import json

url = 'https://hidemail.app/api/v1/aliases'
payload = {
    "page": {
        "number": 38,
        "size": 86
    },
    "search": "jmyuxpcpjtgwmqrequxgpvromuixcdqdmztilwaydcofwpnqilfoxolqrficpyyubxypqxfbritvkvcosucqbahey",
    "filter": {
        "is_active": 90
    },
    "sort": "vziwsmzsjwdpeasjozxsgcbmhpczdatxkjvduvfpijnuyinxdbucjwqgxlpzki",
    "page[size]": 100,
    "page[number]": 1
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "data": [
        {
            "email": "[email protected]",
            "is_active": true,
            "note": null,
            "total_forwarded": 0,
            "total_blocked": 0,
            "created_at": "2023-03-01 21:04:51",
            "updated_at": "2023-03-01 21:12:11"
        },
        {
            "email": "[email protected]",
            "is_active": true,
            "note": null,
            "total_forwarded": 0,
            "total_blocked": 0,
            "created_at": "2023-03-01 21:04:51",
            "updated_at": "2023-03-01 21:12:11"
        }
    ]
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/v1/aliases

Headers

Authorization

Example: Bearer {YOUR_AUTH_KEY}

Content-Type

Example: application/json

Accept

Example: application/json

Body Parameters

page object optional

number integer optional

Must be at least 1. Example: 38

size integer optional

Must not be greater than 100. Must be at least 1. Example: 86

filter object optional

is_active integer optional

Must not be greater than 1. Must be at least 0. Example: 90

search string optional

Must not be greater than 25 characters. Must be at least 3 characters. Example: jmyuxpcpjtgwmqrequxgpvromuixcdqdmztilwaydcofwpnqilfoxolqrficpyyubxypqxfbritvkvcosucqbahey

sort string optional

Must not be greater than 50 characters. Must be at least 3 characters. Example: vziwsmzsjwdpeasjozxsgcbmhpczdatxkjvduvfpijnuyinxdbucjwqgxlpzki

Must be one of:

email
is_active
created_at
updated_at
total_blocked
total_forwarded
-total_blocked
-total_forwarded
-email
-is_active
-created_at
-updated_at

page[size] integer optional

Example: 100

page[number] integer optional

Example: 1

Activate an alias.

requires authentication

This endpoint lets you update the status of an alias to active.

Example request:

curl --request POST \
    "https://hidemail.app/api/v1/active-aliases" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"email\": \"[email protected]\"
}"

const url = new URL(
    "https://hidemail.app/api/v1/active-aliases"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "email": "[email protected]"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$url = 'https://hidemail.app/api/v1/active-aliases';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'email' => '[email protected]',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

import requests
import json

url = 'https://hidemail.app/api/v1/active-aliases'
payload = {
    "email": "[email protected]"
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "data": {
        "email": "[email protected]",
        "is_active": true,
        "note": null,
        "total_forwarded": 0,
        "total_blocked": 0,
        "created_at": "2023-03-01 21:04:51",
        "updated_at": "2023-03-01 21:12:11"
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/v1/active-aliases

Headers

Authorization

Example: Bearer {YOUR_AUTH_KEY}

Content-Type

Example: application/json

Accept

Example: application/json

Body Parameters

email string

The email you want to activate Example: [email protected]

Deactivate an alias.

requires authentication

This endpoint lets you update the status of an alias to in active.

Example request:

curl --request DELETE \
    "https://hidemail.app/api/v1/delete-aliases" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"email\": \"[email protected]\"
}"

const url = new URL(
    "https://hidemail.app/api/v1/delete-aliases"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "email": "[email protected]"
};

fetch(url, {
    method: "DELETE",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$url = 'https://hidemail.app/api/v1/delete-aliases';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'email' => '[email protected]',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

import requests
import json

url = 'https://hidemail.app/api/v1/delete-aliases'
payload = {
    "email": "[email protected]"
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('DELETE', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "data": {
        "email": "[email protected]",
        "is_active": true,
        "note": null,
        "total_forwarded": 0,
        "total_blocked": 0,
        "created_at": "2023-03-01 21:04:51",
        "updated_at": "2023-03-01 21:12:11"
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

DELETE api/v1/delete-aliases

Headers

Authorization

Example: Bearer {YOUR_AUTH_KEY}

Content-Type

Example: application/json

Accept

Example: application/json

Body Parameters

email string

The email you want to deactivate Example: [email protected]

requires authentication

This endpoint lets you create a webhook URL. After you get email on any of your aliases we will send all data to this URL. You can do automation with this data and create your own integrations.

Example request:

curl --request POST \
    "https://hidemail.app/api/v1/subscribe" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"hookUrl\": \"http:\\/\\/schuppe.com\\/labore-ut-asperiores-maxime-dicta\"
}"

const url = new URL(
    "https://hidemail.app/api/v1/subscribe"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "hookUrl": "http:\/\/schuppe.com\/labore-ut-asperiores-maxime-dicta"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$url = 'https://hidemail.app/api/v1/subscribe';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'hookUrl' => 'http://schuppe.com/labore-ut-asperiores-maxime-dicta',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

import requests
import json

url = 'https://hidemail.app/api/v1/subscribe'
payload = {
    "hookUrl": "http:\/\/schuppe.com\/labore-ut-asperiores-maxime-dicta"
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (401):

Show headers

cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *


{
    "message": "Not authenticated"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Remove a webhook URL.

requires authentication

This endpoint lets you remove a webhook URL.

Example request:

curl --request DELETE \
    "https://hidemail.app/api/v1/unsubscribe" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

const url = new URL(
    "https://hidemail.app/api/v1/unsubscribe"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$url = 'https://hidemail.app/api/v1/unsubscribe';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

import requests
import json

url = 'https://hidemail.app/api/v1/unsubscribe'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('DELETE', url, headers=headers)
response.json()

Example response (401):

Show headers

cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *


{
    "message": "Not authenticated"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Delete api token

requires authentication

This endpoint lets you remove a webhook URL.

Example request:

curl --request DELETE \
    "https://hidemail.app/api/v1/delete-token" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

const url = new URL(
    "https://hidemail.app/api/v1/delete-token"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$url = 'https://hidemail.app/api/v1/delete-token';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

import requests
import json

url = 'https://hidemail.app/api/v1/delete-token'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('DELETE', url, headers=headers)
response.json()

Example response (401):

Show headers

cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *


{
    "message": "Not authenticated"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Introduction

Authenticating requests

Endpoints

Create a token.

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

Body Parameters

GET api/user

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

POST api/v1/email/create

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

GET api/v1/domain-options

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

Create a new email alias.

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

Body Parameters

Update an email alias note.

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

Body Parameters

Get all aliases.

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

Body Parameters

Activate an alias.

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

Body Parameters

Deactivate an alias.

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

Body Parameters

Set a webhook URL.

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

Body Parameters

Remove a webhook URL.

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

Delete api token

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request