---
title: "Send Reset Password Code"
description: "Send a code to the user's email address for resetting the password."
api: "POST /api/v1/auth/password/send-reset-code"
---

## Request

### Headers

<ParamField header="X-Stack-Project-Id" type="string">
  The unique identifier of the project.
</ParamField>

<ParamField header="X-Stack-Publishable-Client-Key" type="string">
  The publishable client key.
</ParamField>

### Body

<ParamField body="email" type="string" required>
  The email address of the user requesting a password reset.
</ParamField>

<ParamField body="callback_url" type="string" required>
  The base callback URL to construct the reset link from. A query parameter `code` with the reset code will be appended to it.
</ParamField>

## Response

<ResponseField name="success" type="string" required>
  Indicates the reset code was sent successfully.
</ResponseField>

<CodeGroup>
```bash cURL
curl -X POST "https://api.stack-auth.com/api/v1/auth/password/send-reset-code" \
  -H "Content-Type: application/json" \
  -H "X-Stack-Project-Id: <project-id>" \
  -H "X-Stack-Publishable-Client-Key: <client-key>" \
  -d '{
    "email": "johndoe@example.com",
    "callback_url": "https://example.com/handler/password-reset"
  }'
```

```javascript JavaScript
const response = await fetch("https://api.stack-auth.com/api/v1/auth/password/send-reset-code", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Stack-Project-Id": "<project-id>",
    "X-Stack-Publishable-Client-Key": "<client-key>"
  },
  body: JSON.stringify({
    email: "johndoe@example.com",
    callback_url: "https://example.com/handler/password-reset"
  })
});
const data = await response.json();
```
</CodeGroup>
