---
title: "POST /wishlists/{wishlist_id}/token"
method: POST
path: "/wishlists/{wishlist_id}/token"
tags: ["wishlists"]
---

# POST /wishlists/{wishlist_id}/token

`POST /wishlists/{wishlist_id}/token`

## Request

- Base URL: `https://api.outdoorsy.com/v0`
- URL: `https://api.outdoorsy.com/v0/wishlists/{wishlist_id}/token`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `API-Key`
- TypeScript: <https://skmtc.dev/outdoorsy/apis/outdoorsy-api-documentation/docs/wishlists/:wishlist_id/token/post.ts> (a function with typed inputs; its response is checked against the schema)

Gets existing, non-expired invite token for a wishlist or creates and returns a new one

## Response `201`

- GetWishlistInviteTokenResponse
  - `token` string
  - `wishlist_id` integer

## Other responses

- `400`: Invalid input or state means you're bad
- `401`: Unauthorized error
- `404`: Not found error
- `default`: An unknown, unexpected error.

---

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