---
title: "Create a new conversation"
method: POST
path: "/v4/authvia/conversations"
tags: ["Authvia TXT2PAY"]
---

# Create a new conversation

`POST /v4/authvia/conversations`

## Request body

- object
  - `merchantId` string, int32 — The merchant ID from NMI. This is only required for partners; for merchants it is ignored.
  - `phone` string, required — The conversation customer's ten-digit phone number. US and CA numbers only.
  - `amount` union, required
    - string, float — The amount of the payment, in USD. Should qualify to two decimal places.
    - integer — The amount of the payment in fractional base currency (i.e., pennies).
  - `firstName` string, required — The conversation customer's first name.
  - `lastName` string, required — The conversation customer's last name.
  - `expiration` string, required — The time to wait for the payment to be completed before it is marked failed. A short time duration value is acceptable such as 30m, 1d, or 7d. If no unit is provided, seconds are used.
  - `instructions` string, required — A short intro or message to send along with the payment request to help provide more context.
  - `topic` string, required — The resolution this conversation is trying to reach.

## Response `200`

The conversation was created successfully.

- object
  - `id` string, required — The Authvia v4 UUID for the conversation.
  - `phone` string, required — The conversation customer's phone number separated with dashes.
  - `date` string, date-time, required — The creation date for the conversation.
  - `status` 'in progress' | 'expired' | 'completed', required — The conversation status.
  - `firstName` string, required — The conversation customer's first name.
  - `lastName` string, required — The conversation customer's last name.
  - `recordId` string, required — The NMI marketplace v4 UUID for the conversation.
  - `expiration` string, date-time, required — The expiration date for the conversation.
  - `amount` string, required — The conversation amount in USD.
  - `topic` string, required — The resolution this conversation is trying to reach.
  - `instructions` string, required — A short intro or message to send along with the payment request to help provide more context.

---

[API](https://skmtc.net/nmi/apis/embedded-components-api.md) · [All operations](https://skmtc.net/nmi/apis/embedded-components-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nmi/embedded-components-api/revisions/45c2ecda3685/schema)