---
title: "Verify contact secret"
method: POST
path: "/contact/{contactId}/secret/{secretId}/verify"
tags: ["Contact Secret"]
---

# Verify contact secret

`POST /contact/{contactId}/secret/{secretId}/verify`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/contact/{contactId}/secret/{secretId}/verify`
- Auth: HTTP bearer

## Path parameters

- `contactId` string, required: The ID of the contact the secret belongs to
- `secretId` string, required: The ID of the secret to be verified

## Request body

- object

## Response `200`

The contact secret was verified successfully

- object
  - `id` string, required: The ID of the verified secret
  - `status` 'unauthenticated' | 'authenticated', required: The status of the secret
  - `action` object: The action to take next
    - `type` 'authenticate', required: The type of action to take
    - `url` string, required: The URL to authenticate the secret

## Other responses

- `default`: An error response

---

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