---
schema_version: "1"
id: e369a88fee7d5278359d91319f53ab187caa2a8c255c64382f13f1ecd46efcc7
title: Create Conversation
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/agentic-memory-context/references/agentic-memory-context-ref/agentic-memory-api-create-conversation.md
canonical_url: https://developer.salesforce.com/docs/data/agentic-memory-context/references/agentic-memory-context-api-ref/agentic-memory-api-create-conversation.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 8cad7afa3864f5a93933b4637b73819e2f73604d23448e50999442b166b25896
products:
  - Agentic Memory & Context
  - Data 360 Developer Documentation
---
# Create Conversation

Create a new conversation entity. Provide a unique conversation ID, ownership information, and optional metadata.

**URI:** `/api/v1/agentic/conversations`

**Format:** `application/json`

**HTTP Method:** `POST`

**Authentication:** Bearer JWT

## Prerequisites

- Register the agent in Data 360.
- Obtain a valid JWT token with the required permissions.
- Configure a data space for Agentic Memory.

## Request Headers

| Header        | Required | Description                |
| ------------- | -------- | -------------------------- |
| Authorization | Yes      | Bearer JWT token.          |
| agent_id      | Yes      | Registered agent API name. |
| Content-Type  | Yes      | `application/json`.        |

## Request Body Schema

| Field               | Type   | Required | Description                                                                                                    |
| ------------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------- |
| conversationId      | String | Yes      | Caller-supplied unique identifier for this conversation.                                                       |
| conversationOwnerId | String | Yes      | Individual or User ID of the conversation owner.                                                               |
| ownerType           | String | Yes      | Type of owner. Values: `individual`, `employee`.                                                               |
| name                | String | No       | Human-readable name for the conversation.                                                                      |
| channel             | Object | No       | Communication channel information. Contains `type` (`web`, `chat`, `voice`, `sms`, `email`, `other`) and `id`. |
| variable            | Map    | No       | Arbitrary string key-value metadata.                                                                           |

### Example Request

```json
{
  "conversationId": "conv-2025-001",
  "conversationOwnerId": "003AB000000XYZ",
  "ownerType": "individual",
  "name": "Support — onboarding",
  "channel": { "type": "chat", "id": "slack-C0123" }
}
```

## Response Body Schema

| Field          | Type   | Description                          |
| -------------- | ------ | ------------------------------------ |
| statusCode     | String | Operation status. Value: `created`.  |
| conversationId | String | The created conversation identifier. |

### Example Response

**Status:** `201 Created`

```json
{
  "statusCode": "created",
  "conversationId": "conv-2025-001"
}
```

## Error Codes

| Status Code | Description                                                     |
| ----------- | --------------------------------------------------------------- |
| 400         | Bad Request. Invalid request format or missing required fields. |
| 401         | Unauthorized. Invalid or missing JWT token.                     |
| 500         | Internal Server Error.                                          |