---
title: "Set a webhook URL."
method: POST
path: "/api/v1/subscribe"
tags: ["Endpoints"]
---

# Set a webhook URL.

`POST /api/v1/subscribe`

## Request

- Base URL: `https://hidemail.app`
- URL: `https://hidemail.app/api/v1/subscribe`
- Auth: HTTP bearer

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. The URL must use https, and the account owner is emailed whenever the webhook changes.

## Request body

- object
  - `hookUrl` string, required: An https URL that receives a copy of every incoming email.

## Other responses

- `401`

---

[API](https://skmtc.dev/hidemail/apis/hidemail-app-api.md) · [All operations](https://skmtc.dev/hidemail/apis/hidemail-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hidemail/apis/hidemail-app-api/revisions/168255500dfd?raw)