---
title: "Create a Redirect"
method: POST
path: "/2024-09/account/redirects"
tags: ["Redirects"]
---

# Create a Redirect

`POST /2024-09/account/redirects`

Create a redirect to the Easyship Dashboard.

Required authorization scope: `public.redirect:write`

## Request body

- union
  - RedirectBaseCreate
    - `target` 'account_addresses' | 'account_billing' | 'account_company' | 'account_payment_methods' | 'account_profile' | 'account_subscription' | 'account_team' | 'analytics' | 'connect' | 'couriers' | 'help' | 'pickups' | 'products' | 'settings_boxes' | 'settings_email' | 'settings_insurance' | 'settings_notifications' | 'settings_packing_slip' | 'settings_printing_options' | 'settings_tracking_page' | 'shipment_create' | 'shipment_create_advanced' | 'shipments_all' | 'shipments_pending' | 'shipments_rejected' | 'shipments_to_print' | 'shipping_rules' | 'webhooks', required — The target of the redirect.
  - RedirectWithShipmentIDCreate
    - `target` 'shipment' | 'shipment_order' | 'ups_dap', required — The target of the redirect.
    - `value` string, required — Easyship Shipment ID
  - RedirectUPSDAPCreate
    - `target` 'ups_dap', required — The target of the redirect.
    - `country` 'US' | 'GB' | 'CA' | 'DE' | 'NL', required — Country Code in Alpha-2 format (ISO 3166-1)
    - `redirect_back_url` string, uri, required — Where to redirect back to after the target has been completed. A query param `ups_dap_status` will be added to the URL with the status of the UPS DAP (`accepted` or `cancelled`).

## Response `200`

redirect to UPS DAP

- RedirectSingle — Redirect Detail
  - `redirect` Redirect — Redirect Detail
    - `url` string, uri — The URL that the user should be redirected to.
    - `expires_at` string, date-time — The date and time that the redirect will expire.
  - `meta` Meta
    - `request_id` string — An unique ID represent the request.

## Other responses

- `422` — missing redirect_back_url

---

[API](https://skmtc.net/easyship/apis/easyship-public-api.md) · [All operations](https://skmtc.net/easyship/apis/easyship-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/easyship/easyship-public-api/versions/71d737a5fcbf/schema)