---
title: "Generate Invitation Code"
method: POST
path: "/api/v1/users/{user_id}/invitation-code"
tags: ["External: Mobile SDK"]
---

# Generate Invitation Code

`POST /api/v1/users/{user_id}/invitation-code`

Generate a single-use invitation code for SDK user onboarding.

The code can be shared with a mobile app user who enters it to receive
SDK access and refresh tokens without manually entering user_id and tokens.

Previously generated codes for this user are marked as expired.

Requires developer authentication.

## Path parameters

- `user_id` string, uuid, required

## Response `201`

Successful Response

- UserInvitationCodeRead — Response schema after generating an invitation code.
  - `id` string, uuid, required
  - `code` string, required
  - `user_id` string, uuid, required
  - `expires_at` string, date-time, required
  - `created_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/openwearables/apis/open-wearables-api.md) · [All operations](https://skmtc.net/openwearables/apis/open-wearables-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openwearables/open-wearables-api/versions/37c1c527cd8f/schema)