---
title: "Set the sending identity"
method: POST
path: "/accounts/sender-identity"
tags: ["Email Sending"]
---

# Set the sending identity

`POST /accounts/sender-identity`

## Request

- Base URL: `https://api.quiva.ai`
- URL: `https://api.quiva.ai/accounts/sender-identity`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/docs/accounts/sender-identity/post.ts> (a function with typed inputs; its response is checked against the schema)

Sets the sending domain and from address, then provisions the sending side. Admin only, because the sending domain is the account's outbound reputation.

## Request body

- object
  - `domain` string: Sending domain
  - `from_address` string: From address
  - `display_name` string: Display name
  - `reply_to` string: Reply-to address
  - `failure_task_space_id` string: Space where a failed email raises a task
  - `track_engagement` boolean

## Response `200`

Success

- object
  - `data` object: Sending identity: domain, from_address, display_name, reply_to, DNS records and verification state

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Caller is not an admin or root

## Changes

- **2026-11-12** `700eb1ace61a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/changes/accounts/sender-identity/post.md)

---

[API](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway.md) - [All operations](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/revisions/700eb1ace61a?raw)