---
title: "Confirm a signup email"
method: POST
path: "/v1/workspaces/verify"
tags: ["Account"]
---

# Confirm a signup email

`POST /v1/workspaces/verify`

## Request

- Base URL: `https://api.recruitmcp.com`
- URL: `https://api.recruitmcp.com/v1/workspaces/verify`
- Auth: none required

No authentication.

## Request body

- object
  - `token` string, required

## Response `200`

Verification outcome.

- Verification
  - `verified` boolean, required
  - `workspace_id` string
  - `granted_credits` integer
  - `reason` string

## Other responses

- `400`: `invalid_request` (do not retry): A field is missing or has a value this endpoint does not accept. `unsupported_version` (do not retry): RecruitMCP-Version is not a supported version.
- `404`: `invalid_verification_link` (do not retry): This confirmation link is invalid, used, or expired.
- `429`: `rate_limited` (retry): Too many requests from this network. Try again later.

## Changes

- **2026-10-20** `ad27b35513a6`: 3 warning
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `400`
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `404`
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `429`

[Operation history](https://skmtc.dev/recruitmcp/apis/recruitmcp-api/changes/v1/workspaces/verify/post.md)

---

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