---
title: "Finish a Call Connect authentication session."
method: POST
path: "/call/finish"
tags: ["call-connect-api"]
---

# Finish a Call Connect authentication session.

`POST /call/finish`

Finish an existing Call Connect authentication session.

## Request body

- object
  - `referenceId` string, required — A reference identifier originating from customer experience/IVR system. This could be the call session ID.
  - `userId` string — The primary identifier for the user stored in Authsignal.
  - `state` 'CHALLENGE_SUCCEEDED' | 'CHALLENGE_FAILED', required — The state of the call connect session.
  - `payload` object — Any metadata that you want to pass along to the webhook.

## Response `200`

OK

- object
  - `success` boolean

## Other responses

- `400` — Invalid Request
- `401` — Unauthorized

---

[API](https://skmtc.dev/authsignal/apis/call-connect-api.md) · [All operations](https://skmtc.dev/authsignal/apis/call-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/authsignal/call-connect-api/revisions/5604d744e3ad/schema)