---
title: "Edit the return-path subdomain"
method: POST
path: "/domain/returnpath"
tags: ["SENDER DOMAINS"]
---

# Edit the return-path subdomain

`POST /domain/returnpath`

A Return Path Subdomain is used to instruct the server where to return emails that are not deliverable (ie. Bounces).  This endpoint allows you to edit a Return Path Subdomain for a particular sender domain. Full details can be found in the Sender Domain Guide.

## Request body

- object
  - `domain` string, required — The sender domain to edit the return-path subdomain for
  - `old_subdomain` string, required — The domains old return-path subdomain
  - `new_subdomain` string, required — The domains new return-path subdomain
  - `subaccount_id` string — If you wish to make this API call on behalf of a subaccount then include its unique ID here

## Response `200`

Return-path subdomain edited

- object
  - `request_id` string, required
  - `data` object, required
    - `domains` object[], required
      - `domain` object
        - `dkim_value` string, required
        - `domain` string, required
        - `suffix` string, required
        - `rpath_selector` string
        - `rpath_status` string, required
        - `rpath_verified` boolean
        - `rpath_value` string, required
        - `dkim_status` string, required
        - `dkim_verified` boolean
        - `subdomain` unknown, required
        - `fulldomain` string, required
        - `dkim_selector` string, required
      - `trackers` object[]
        - `cname_value` string, required
        - `cname_status` string, required
        - `cname_verified` boolean
        - `domain` string
        - `suffix` string
        - `subdomain` string
        - `enabled` boolean
        - `fulldomain` string
      - `subaccount_access` object
        - `subaccounts` unknown[] — A list of subaccount IDs that were given access the sender domain.
          - unknown
        - `future_subaccounts` boolean — If true, any new subaccounts added will automatically be given access.

## Other responses

- `400` — 400

---

[API](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4.md) · [All operations](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smtp2go/smtp2go-api-v3-0-4/versions/1ba6b25eebb9/schema)