---
title: "Set My Payout Email"
method: PUT
path: "/api/v1/playbooks/my/payout-email"
tags: ["playbooks"]
---

# Set My Payout Email

`PUT /api/v1/playbooks/my/payout-email`

## Request

- Base URL: `https://api.badgeia.com`
- URL: `https://api.badgeia.com/api/v1/playbooks/my/payout-email`
- Auth: none declared

Store the caller's payout email (F-01 lean v1).

This is the ONLY payout detail collected in lean v1 — no KYC, no bank
details. A user can only set their own payout email (the seller identity is
`current_user`, never a path/body-supplied user id), so there is no
cross-user write surface here. When Stripe Connect lands (deferred), this
email seeds the Connect onboarding link.

## Request body

- PayoutEmailUpdate: Body for PUT /playbooks/my/payout-email.
  - `payout_email` string, email, required

## Response `200`

Successful Response

- PayoutEmailRead
  - `payout_email` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/badgeia/apis/badge.md) · [All operations](https://skmtc.dev/badgeia/apis/badge/llms.txt) · [OpenAPI document](https://skmtc.dev/badgeia/apis/badge/revisions/7e7f7fee8b77?raw)