> ## Documentation Index
> Fetch the complete documentation index at: https://usegately.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Email Sender Settings

> Get or update the email sender name and address used for all transactional and campaign emails

Controls the From name and email address shown to recipients on every email your project sends — magic links, password resets, member invitations, and campaigns.

<Info>
  **How sender resolution works**

  1. If `sender_email` is set and you have a **verified sending domain**, emails send from `sender_name <sender_email>` directly.
  2. If `sender_email` is set but no verified domain, the sender name is applied and `sender_email` is used as the Reply-To.
  3. If neither is set, emails fall back to `Gately <hello@usegately.com>`.

  Set up a verified sending domain in **Dashboard → Campaigns → Sending Domains** for full From address control.
</Info>

## GET /settings/email

Retrieve current email sender configuration.

### Headers

<ParamField header="Authorization" type="string" required>
  `Bearer YOUR_API_KEY`
</ParamField>

### Response

<ResponseField name="sender_email" type="string | null">
  Configured From email address
</ResponseField>

<ResponseField name="sender_name" type="string | null">
  Configured From display name
</ResponseField>

<ResponseField name="reply_to_email" type="string | null">
  Configured Reply-To address
</ResponseField>

## PUT /settings/email

Update email sender configuration.

### Request Body

<ParamField body="sender_name" type="string" required>
  Display name shown in the From field (e.g. `"Magana Team"`)
</ParamField>

<ParamField body="sender_email" type="string" required>
  Email address for the From field (e.g. `"hello@magana.com"`)
</ParamField>

<ParamField body="reply_to_email" type="string">
  Reply-To address. If omitted, defaults to `sender_email`.
</ParamField>

<RequestExample>
  ```bash GET sender settings theme={null}
  curl "https://api.usegately.com/api/v1/settings/email" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```bash PUT — update sender theme={null}
  curl -X PUT "https://api.usegately.com/api/v1/settings/email" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "sender_name": "Magana Team",
      "sender_email": "hello@magana.com",
      "reply_to_email": "support@magana.com"
    }'
  ```

  ```typescript SDK theme={null}
  // Get
  const email = await gately.settings.getEmail()

  // Update
  await gately.settings.updateEmail({
    sender_name: 'Magana Team',
    sender_email: 'hello@magana.com',
    reply_to_email: 'support@magana.com',
  })
  ```
</RequestExample>

<ResponseExample>
  ```json GET 200 theme={null}
  {
    "success": true,
    "data": {
      "sender_email": "hello@magana.com",
      "sender_name": "Magana Team",
      "reply_to_email": "support@magana.com"
    }
  }
  ```

  ```json PUT 200 theme={null}
  {
    "success": true,
    "data": {
      "sender_email": "hello@magana.com",
      "sender_name": "Magana Team",
      "reply_to_email": "support@magana.com"
    }
  }
  ```
</ResponseExample>