---
title: "POST /team/email-sender/domain"
method: POST
path: "/team/email-sender/domain"
tags: ["team"]
---

# POST /team/email-sender/domain

`POST /team/email-sender/domain`

## Request

- Base URL: `https://api.scalar.com/core`
- URL: `https://api.scalar.com/core/team/email-sender/domain`
- Auth: HTTP bearer

Claim a domain to send login portal emails from, and get the DNS records that verify it

## Request body

- object
  - `domain` string, required

## Response `200`

Default Response

- TeamEmailSender
  - `fromName` string, nullable
  - `replyTo` string, email
  - `localPart` string, nullable
  - `domain` string, nullable
  - `postmarkDomainId` integer, nullable
  - `domainStatus` 'pending' | 'active' | 'failed', nullable
  - `dkim` object, nullable
    - `host` string, required
    - `value` string, required
  - `returnPath` object, nullable
    - `host` string, required
    - `target` string, required
  - `returnPathVerified` boolean, nullable
  - `checkedAt` integer
  - `claimedAt` integer

## Other responses

- `400`: Bad request
- `401`: No auth
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid payload
- `500`: Uncaught error

## Changes

- **2026-10-19** `8768b07df13f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scalar/apis/core/changes/team/email-sender/domain/post.md)

---

[API](https://skmtc.dev/scalar/apis/core.md) - [All operations](https://skmtc.dev/scalar/apis/core/llms.txt) - [OpenAPI document](https://skmtc.dev/scalar/apis/core/revisions/b3aa8493faa8?raw)