# Create Conversation

**POST** `/v0/copilots/createConversation`

OPTIONAL. Create a new conversation with the Agent. The conversation ID can be used in the `sendMessage` endpoint. The `sendMessage` endpoint automatically creates new conversations upon first request, but calling this endpoint can simplify certain use cases where it is helpful for the application to have the conversation ID before the first message is sent.

Base URL: `https://api.credal.ai/api`

Tags: `copilots`

## Authorization

| Option | Scheme | Type | Sent as | Scopes |
| --- | --- | --- | --- | --- |
| Option 1 | `BearerAuthScheme` | `http` | `Authorization: Bearer <token>` | — |

## Request body

Optional. Media type: `application/json`

### Example request body

```json
{
  "agentId": "00000000-0000-0000-0000-000000000000",
  "userEmail": "string"
}
```

## Responses

| Status | Description | Media type |
| --- | --- | --- |
| `200` | Response with status 200 | `application/json` |

### Example response: 200 — Response with status 200

```json
{
  "conversationId": "00000000-0000-0000-0000-000000000000"
}
```

## Related pages

- [Add Collection To Copilot](./copilots_addcollectiontocopilot.md)
- [Add Documents To Collection](./documentcollections_adddocumentstocollection.md)
- [API Reference](../../api.md)
- [copilots](./tags/copilots.md)
- [Create Collection](./documentcollections_createcollection.md)
- [Create Copilot](./copilots_createcopilot.md)
- [Create Mongo Collection Sync](./documentcollections_createmongocollectionsync.md)
- [Delete Collection](./documentcollections_deletecollection.md)
- [Delete Copilot](./copilots_deletecopilot.md)
- [documentCatalog](./tags/documentcatalog.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.