---
title: "Accept invitation and set password"
method: POST
path: "/auth/invitation/accept"
tags: ["Auth"]
---

# Accept invitation and set password

`POST /auth/invitation/accept`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/auth/invitation/accept`
- Auth: none declared

Accept an invitation by setting a password. Returns auth tokens on success.

## Request body

- object
  - `token` string, required: The invitation token
  - `password` string, password, required: The user's new password (min 8 characters)

## Response `200`

Invitation accepted successfully

- object
  - `success` boolean
  - `data` object
    - `message` string
    - `user` User
      - `id` string, uuid
      - `email` string
      - `first_name` string
      - `last_name` string
      - `job_title` string
      - `avatar_url` string
      - `initials` string
      - `display_name` string
      - `personas` object[]
    - `tokens` AuthTokens
      - `accessToken` string
      - `refreshToken` string
      - `expiresIn` number

## Other responses

- `400`: Invalid request
- `404`: Invalid or expired invitation

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)