---
title: "Create note"
method: POST
path: "/ccaas/1/conversations/{conversationId}/notes"
tags: ["customer-engagement", "conversations", "conversation-notes"]
---

# Create note

`POST /ccaas/1/conversations/{conversationId}/notes`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/ccaas/1/conversations/{conversationId}/notes`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Use this method to create a new note. Use notes to notify your team on important matters regarding a conversation with a customer. <a href="https://www.infobip.com/docs/conversations-api/notes" target="_blank">More info</a>

## Path parameters

- `conversationId` string, required

## Request body

- E89661b226e518f36a162935afcdf1132c95b0e63e9c86c5ef5f31c5a8d865a2CreateNoteApiRequest
  - `type` 'INTERNAL' | 'ATTACHMENT'
  - `content` E89661b226e518f36a162935afcdf1132c95b0e63e9c86c5ef5f31c5a8d865a2NoteContent, required: Notes content can be any text.
  - `agentId` string: Agent Id, creator of note.

## Response `200`

OK

- E89661b226e518f36a162935afcdf1132c95b0e63e9c86c5ef5f31c5a8d865a2NoteApiResponse
  - `id` string: Note Id
  - `conversationId` string: Id of the conversation holding the note.
  - `agentId` string: Id of the author agent.
  - `content` string: Note content, which can be any text up to 4000 characters.
  - `type` 'INTERNAL' | 'AUTH_BIOMETRY_INIT' | 'AUTH_BIOMETRY_PENDING' | 'AUTH_BIOMETRY_SUCCESS' | 'AUTH_BIOMETRY_EXPIRED' | 'AUTH_BIOMETRY_CANCEL' | 'AUTH_BIOMETRY_FAILED' | 'AUTH_AGENT_SUCCESS' | 'AUTH_AGENT_EXPIRED' | 'AUTH_BOT_SUCCESS' | 'AUTH_BOT_EXPIRED' | 'JIRA_COMMENT' | 'ATTACHMENT' | 'INTERNAL' | 'ATTACHMENT'
  - `createdAt` string, date-time: Time stamp when note is created.
  - `updatedAt` string, date-time: Time stamp when note is updated.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)