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

# Create Return Address

> Create a new return address

Create a new return address. The address is validated against USPS address data before saving. If the address is undeliverable, the request is rejected with a `400`.

If USPS corrects the address, the corrected version is saved and `corrected: true` is returned.

<ParamField body="name" type="string" required>Name on the return address</ParamField>
<ParamField body="label" type="string">Friendly label (e.g., "Office", "Home")</ParamField>
<ParamField body="address_1" type="string" required>Street address</ParamField>
<ParamField body="address_2" type="string">Apt/Suite/Unit</ParamField>
<ParamField body="city" type="string" required>City</ParamField>
<ParamField body="state" type="string" required>Two-letter state code</ParamField>
<ParamField body="zip" type="string" required>ZIP code</ParamField>
<ParamField body="set_as_default" type="boolean" default="false">Make this the default return address</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.v2.dealmachine.com/v1/mail/return-addresses \
    -H "Authorization: Bearer dm_sk_live_xxx" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Acme Real Estate",
      "label": "Office",
      "address_1": "456 Business Ave",
      "address_2": "Suite 200",
      "city": "Austin",
      "state": "TX",
      "zip": "78702",
      "set_as_default": true
    }'
  ```
</RequestExample>