---
title: "Submit a wizard step for shareholder onboarding (public, no auth required)"
method: POST
path: "/api/v1/shareholder-invitations/submit-step"
tags: ["Shareholder Invitations"]
---

# Submit a wizard step for shareholder onboarding (public, no auth required)

`POST /api/v1/shareholder-invitations/submit-step`

Submit a wizard step for shareholder onboarding (public, no auth required)

## Request body

- ShareholderInvitationSubmitStepBody — Request body for submitting a wizard step. The payload field accepts step-specific data; per-step validation is applied using Step1PayloadSchema/Step2PayloadSchema.
  - `token` string, required — Raw invitation token
  - `step` number, required — Step number being submitted (0, 1, or 2)
  - `payload` unknown

## Response `200`

Success

- ShareholderInvitationSubmitStepResponse — Response from submitting a wizard step
  - `success` boolean, required — Indicates if the request was successful
  - `data` object, required — Result of submitting a wizard step
    - `next_step` number, nullable, required — Next step to display, or null if complete

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `410` — Response

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/revisions/f86d2bdbcb08/schema)