---
title: "Get ephemeral token"
method: POST
path: "/v1/tokens/ephemeral"
tags: ["tokens"]
---

# Get ephemeral token

`POST /v1/tokens/ephemeral`

This endpoint returns a token that can be passed to an application for authorized access.  The lifetime of this token is 10 seconds.

## Query parameters

- `redirect` 'shipengine-dashboard' — The resource to return a redirect URL to.

## Response `200`

OK

- TokensGetEphemeralTokenResponseBodyYaml
  - `token` string — The requested token that expires in 10 seconds.
  - `redirect_url` string — The redirect url formatted with the requested token.

## Other responses

- `400` — The request contained errors.
- `500` — An error occurred on ShipEngine's side. > This error will automatically be reported to our engineers.

## Changes

- **2026-08-15** `f3a66d204565` — 12 warning
  - added the new `freight_connection_inactive` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `freight_connection_inactive` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `freight_provider_id_required` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `freight_provider_id_required` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - …8 more

[Change history](https://skmtc.dev/shipstation/apis/shipengine-api/changes/v1/tokens/ephemeral/post.md)

---

[API](https://skmtc.dev/shipstation/apis/shipengine-api.md) · [All operations](https://skmtc.dev/shipstation/apis/shipengine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/shipstation/shipengine-api/revisions/422fd75e1e35/schema)