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

# Update email sender details

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Changes the name or address your app's mail is sent from.

The domain part of `from_email` has to be a domain this app already has set up for email. The call edits that domain's sender details and nothing else, so it never changes which domain your mail goes out from. Use [Replace the email domain](/api-reference/replace-the-email-domain) for that.

The change applies at once and doesn't re-run verification, so a domain that was `active` keeps sending.



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json patch /api/apps/{app_id}/custom-email-domains
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - ApiKeyAuth: []
paths:
  /api/apps/{app_id}/custom-email-domains:
    patch:
      summary: Update email sender details
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Changes the name or address your app's mail is sent from.


        The domain part of `from_email` has to be a domain this app already has
        set up for email. The call edits that domain's sender details and
        nothing else, so it never changes which domain your mail goes out from.
        Use [Replace the email domain](/api-reference/replace-the-email-domain)
        for that.


        The change applies at once and doesn't re-run verification, so a domain
        that was `active` keeps sending.
      operationId: update_email_domain_api_apps__app_id__custom_email_domains_patch
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the app whose email domains you want to work with.
            title: App Id
          description: ID of the app whose email domains you want to work with.
          example: 6820f3a4e7b91d003c45a1f2
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateEmailDomainRequest'
      responses:
        '200':
          description: The updated sender details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateEmailDomainResponse'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            You don't have access to this app, you used a workspace API key, or
            the email domain is suspended. A suspended domain says why in the
            message.
        '404':
          description: >-
            The domain in `from_email` isn't set up for email on this app, or
            the app doesn't exist.
        '422':
          description: >-
            The request body is missing a required field or has an invalid
            value.
components:
  schemas:
    UpdateEmailDomainRequest:
      properties:
        sender_name:
          type: string
          title: Sender Name
          description: >-
            Name recipients see in the From line. Required, so resend the
            current value to keep it.
          example: Nordwind Furniture
        from_email:
          type: string
          format: email
          title: From Email
          description: >-
            Address mail is sent from. Its domain has to be one the app already
            has set up for email. Required, so resend the current value to keep
            it.
          example: hello@example.com
      type: object
      required:
        - sender_name
        - from_email
      title: UpdateEmailDomainRequest
      description: Request to update email domain configuration.
    UpdateEmailDomainResponse:
      properties:
        sender_name:
          type: string
          title: Sender Name
          description: The name now in use.
          example: Nordwind Furniture
        from_email:
          type: string
          title: From Email
          description: The address now in use, lower-cased.
          example: hello@example.com
        domain:
          type: string
          title: Domain
          description: The domain this configuration belongs to.
          example: example.com
        configuration_status:
          type: string
          title: Configuration Status
          description: >-
            Where setup stands. Updating these fields doesn't change it. Only
            `active` sends mail. The `pending_` values mean setup is still in
            progress, and the `failed_` values mean it stopped and you can start
            it again with [Retry email domain
            setup](/api-reference/retry-email-domain-setup).
          example: active
      type: object
      required:
        - sender_name
        - from_email
        - domain
        - configuration_status
      title: UpdateEmailDomainResponse
      description: Response for updating email domain configuration.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: Personal API key.

````