In Corti’s API, an interaction is the central object that represents a session or conversation. All data — including audio, transcripts, and analyses — are tied to an interaction. This makes it the starting point for working with the API.
This article explains how to create an interaction after successfully authenticating.
Step 1️⃣ Authenticate to Corti’s API
Before creating an interaction, you must first obtain a valid access token using OAuth 2.0.
👉 See Authenticating to Corti's API for high level steps on getting your access token and visit our API documentation for more details.
Step 2️⃣ Make a Request to Create an Interaction
Once authenticated, send a POST request to:
https://api.{environment}.corti.app/v2/interactions/Request Headers
Header | Value |
|
|
Request Body
The request body defines the details of the interaction.
Customers building on Corti's API are able to pass data to include about the interaction. See the example below from our API documentation:
"encounter": {
"identifier": "{{random_number}}",
"status": "planned",
"type": "first_consultation",
},Step 3️⃣ Review the Response
If successful, Corti will return a response like:
{
"interactionId": "<alphanumeric value>",
"websocketUrl": "<string>"
}✅ The interaction_id is your central reference. Use this ID in any further API calls (such as uploading audio, attaching transcripts, or retrieving results).
What’s Next?
Use the
interaction_idto upload audio or stream audio.Query or update interaction data as needed.
For more details on interactions and related endpoints, see: