---
title: "Registers the tenant and email combination for activation."
method: POST
path: "/emails:register"
tags: ["TenantEmailRegistration"]
---

# Registers the tenant and email combination for activation.

`POST /emails:register`

Register an email for the current tenant

## Query parameters

- `api-version` string, required

## Headers

- `repeatability-request-id` string

## Response `200`

Success

- TenantEmailRegistration — Base data transfer object implementation for proxy resources.
  - `id` string — The unique id of the resource.
  - `type` string — Type of the resource.

## Other responses

- `default` — Default error response.

## Changes

- **2026-07-13** (2021-09-01-preview) `a1ebde565f2f` — 1 breaking
  - api path removed without deprecation
- **2026-07-13** (2021-09-01-preview) `315ab40101a8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/purview-share/changes/emails:register/post.md)

---

[API](https://skmtc.dev/azure/apis/purview-share.md) · [All operations](https://skmtc.dev/azure/apis/purview-share/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/purview-share/revisions/79b396164f79/schema)