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

# Create a Redirect

`POST /2024-09/account/redirects`

## Request

- Base URL: `https://public-api.easyship.com`
- URL: `https://public-api.easyship.com/2024-09/account/redirects`
- Auth: HTTP bearer

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' | 'IT' | 'BE' | 'ES' | 'FR', 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

## Changes

- **2026-11-03** `b47b54b748a7`: 4 info
  - added the new `BE` enum value to the request property `oneOf[#/components/schemas/RedirectUPSDAPCreate]/country`
  - added the new `ES` enum value to the request property `oneOf[#/components/schemas/RedirectUPSDAPCreate]/country`
  - added the new `FR` enum value to the request property `oneOf[#/components/schemas/RedirectUPSDAPCreate]/country`
  - added the new `IT` enum value to the request property `oneOf[#/components/schemas/RedirectUPSDAPCreate]/country`

[Operation history](https://skmtc.dev/easyship/apis/easyship-public-api/changes/2024-09/account/redirects/post.md)

---

[API](https://skmtc.dev/easyship/apis/easyship-public-api.md) - [All operations](https://skmtc.dev/easyship/apis/easyship-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/easyship/apis/easyship-public-api/revisions/b47b54b748a7?raw)