> ## Documentation Index
> Fetch the complete documentation index at: https://tools.lunchpaillabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a conversation

> Use this action to create a conversation. The replica will immediately join the call and billing will start. [Learn more in Tavus's documentation](https://docs.tavus.io/api-reference/conversations/create-conversation)

<Note>
  Please be aware that usage of this action as soon as the conversation is
  created will incur costs. To safeguard against API usage, consider setting
  values for `max call duration`, `participant leave timeout`, and `participant
      absent timeout`.
</Note>

### Fields

| **Field**                      | **Type** | **Description**                                                                                                                                   |
| ------------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **replica id**                 | String   | The unique identifier for the replica that will join the conversation.                                                                            |
| **persona id**                 | String   | The unique identifier for the persona that the replica will use in the conversation.                                                              |
| **callback url**               | String   | A URL that will receive webhooks with updates regarding the conversation state.                                                                   |
| **conversation name**          | String   | A name for the conversation.                                                                                                                      |
| **conversational context**     | String   | Optional context that will be appended to any context provided in the persona, if one is provided.                                                |
| **custom greeting**            | String   | An optional custom greeting that the replica will give once a participant joins the conversation.                                                 |
| **max call duration**          | Number   | The maximum duration of the conversation in seconds. Default is 3600 seconds (1 hour).                                                            |
| **participant leave timeout**  | Number   | The duration in seconds after which the call will automatically end once the last participant leaves.                                             |
| **participant absent timeout** | Number   | The duration in seconds after which the call will automatically end if no participant joins. Default is 300 seconds (5 minutes).                  |
| **enable recording**           | Boolean  | If true, enables the user to record the conversation. See instructions on recording for more details.                                             |
| **enable transcription**       | Boolean  | If true, enables the user to transcribe the conversation.                                                                                         |
| **apply greenscreen**          | Boolean  | If true, replaces the background with a greenscreen (RGB: \[0, 255, 155]). Can be adjusted using WebGL.                                           |
| **language**                   | String   | The language of the conversation. Use the FULL language name (e.g., "English"). Refer to supported languages for Cartesia, ElevenLabs, or PlayHT. |
| **recording s3 bucket name**   | String   | The name of the S3 bucket where the recording will be stored.                                                                                     |
| **recording s3 bucket region** | String   | The region of the S3 bucket where the recording will be stored.                                                                                   |
| **aws assume role arn**        | String   | The ARN of the role that will be assumed to access the S3 bucket.                                                                                 |

### Returned Values

| **Field**             | **Type** | **Description**                                                                      |
| --------------------- | -------- | ------------------------------------------------------------------------------------ |
| **conversation id**   | Text     | A unique identifier for the conversation.                                            |
| **conversation name** | Text     | The name of the conversation.                                                        |
| **status**            | Text     | The status of the conversation. Possible values: `active`, `ended`.                  |
| **conversation url**  | Text     | A direct link to join the conversation. This link can also be embedded in a website. |
| **replica id**        | Text     | A unique identifier for the replica used to create the conversation.                 |
| **persona id**        | Text     | A unique identifier for the persona used to create the conversation.                 |
| **created at**        | Date     | The date and time the conversation was created.                                      |

<CardGroup cols={2}>
  <Card title="Need Help?" icon="envelope" href="/support/plans">
    View our options for free community and priority support.
  </Card>

  <Card title="Have a feature request?" icon="lightbulb" href="https://lunchpaillabs.canny.io/feature-requests?selectedCategory=bubble-video-audio-live">
    Post your feature request on our

    <a href="https://lunchpaillabs.canny.io/feature-requests?selectedCategory=bubble-video-audio-live">
      idea board.
    </a>
  </Card>
</CardGroup>