---
title: "Submit a contact-prompt address"
method: POST
path: "/v1/contacts/prompt/submit"
tags: ["contacts"]
---

# Submit a contact-prompt address

`POST /v1/contacts/prompt/submit`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/contacts/prompt/submit`
- Auth: none declared

Completes a contact_request the assistant broadcast: writes the contact and channel gateway-first, then unblocks the waiting prompt.

## Request body

- object
  - `requestId` string, required: The contact_request id broadcast by the assistant
  - `address` string: Required unless cancelled is true
  - `channelType` string: Required unless cancelled is true
  - `role` string
  - `displayName` string
  - `contactId` string: The contact the parked form targets, echoed back from the broadcast. The parked form is authoritative.
  - `verify` boolean: The form's 'mark verified' checkbox as the guardian left it. Omit only from clients that predate the checkbox; the parked command's flag is then used instead.
  - `cancelled` boolean: The guardian dismissed the form. Unblocks the waiting command without writing.

## Response `200`

Successful response

- object
  - `accepted` boolean, required
  - `error` string
  - `duplicate` boolean: Another client answered this form first. Nothing is wrong, but none of this submission's values were written.

## Changes

- **2026-09-03** `48d611686235`: 1 info
  - added the new optional request property `contactId`
- **2026-08-31** `1c0b7dd0195a`: 5 info
  - added the new optional request property `cancelled`
  - added the new optional request property `verify`
  - the request property `address` became optional
  - the request property `channelType` became optional
  - …1 more
- **2026-07-06** `bf6a3a734a63`: 1 info
  - endpoint added
- **2026-06-15** `8aa43f77a604`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/vellum-ai/apis/vellum-gateway-api/changes/v1/contacts/prompt/submit/post.md)

---

[API](https://skmtc.dev/vellum-ai/apis/vellum-gateway-api.md) - [All operations](https://skmtc.dev/vellum-ai/apis/vellum-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vellum-ai/apis/vellum-gateway-api/revisions/48d611686235?raw)