Create 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.

body namestringrequired

Name on the return address

body labelstring

Friendly label (e.g., "Office", "Home")

body address_1stringrequired

Street address

body address_2string

Apt/Suite/Unit

body citystringrequired

City

body statestringrequired

Two-letter state code

body zipstringrequired

ZIP code

body set_as_defaultbooleandefault: false

Make this the default return address

Request example

12345678910111213curl -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
  }'