---
title: "Accept user invitation"
method: POST
path: "/account/v2/invitations/{invitationToken}/registration"
tags: ["Invitation"]
---

# Accept user invitation

`POST /account/v2/invitations/{invitationToken}/registration`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/account/v2/invitations/{invitationToken}/registration`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/account/v2/invitations/:invitationToken/registration/post.ts> (a function with typed inputs; its response is checked against the schema)

Accept a user's invitation to a marketplace company

## Path parameters

- `invitationToken` string, required

## Query parameters

- `api.usesExternalIds` boolean

## Request body

- UserRegistration, nullable: Resource links
  - `links` Link[]: Resource links
    - `href` string
    - `rel` string
  - `externalIdentifier` string: External identifier of user
  - `firstName` string: First name of user
  - `lastName` string, nullable: Last name of user
  - `locale` string: Locale of user in the standard ISO 639-1 language code + ISO 3166-1 country code format. For example: 'en_US', 'fr_CA' etc
  - `password` string: Password
  - `title` string: Title of user

## Response `200`

Success

## Other responses

- `400`: Invitee is already an active user, first/last names are missing or a user already exists with the same external id
- `401`: Unauthorized
- `403`: Role hierarchy violation. The user making the request cannot change the password of a user with a higher role than their own.
- `404`: Invitation not found

## Changes

- **2026-11-06** `1fc240f06971`: 2 breaking
  - added `#/components/schemas/ResourceSupport, subschema #2: UserRegistration` to the request body `allOf` list
  - removed the media type `*/*` for the response with the status `200`

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/account/v2/invitations/:invitationToken/registration/post.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)