Add Note

API Documentation

POST /api/v1/conversations/{id}/notes

Retrieve a single conversation with all its messages, including sender and recipient details.

Path parameters

• id (string) - Conversation UUID (the id field from List Conversations)

Request Fields

• author_email (string) - Email address of the team member who should be recorded as the note author.
• content (string) - Internal note body.
• mentioned_user_emails (array | null) - Optional list of team member emails to mention.

Response Fields

• id (string) - Unique note ID (UUID).
• conversation_id (string) - Conversation UUID.
• content (string) - Internal note body.

• author (object) - Team member who authored the note.

  • id (string) - Author user ID (UUID)
  • email (string) - Author email address
  • name (string | null) - Author display name

• mentions (array) - Mentioned team members.

  • id (string) - Mentioned user ID (UUID)
  • email (string) - Mentioned user email address
  • name (string | null) - Mentioned user display name
  • created_at (string) - ISO 8601 timestamp.
  • updated_at (string) - ISO 8601 timestamp.

Example Request

curl -X POST "https://api.letterbook.ai/api/webhooks/conversations/YOUR_CONVERSATION_ID/notes" \
  -H "Authorization: Bearer hld_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "author_email": "[email protected]",
    "content": "Customer reported this issue was escalated from Shopify ticket #1234.",
    "mentioned_user_emails": ["[email protected]"]
  }'

Example Response

{
  "id": "n1b2c3d4-5678-90ab-cdef-1234567890ab",
  "conversation_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "content": "Customer reported this issue was escalated from Shopify ticket #1234.",
  "author": {
    "id": "u1b2c3d4-5678-90ab-cdef-1234567890ab",
    "email": "[email protected]",
    "name": "Support Agent"
  },
  "mentions": [
    {
      "id": "u9e8d7c6-5432-10ba-fedc-ba0987654321",
      "email": "[email protected]",
      "name": "Jane Teammate"
    }
  ],
  "created_at": "2026-04-09T15:45:00+00:00",
  "updated_at": "2026-04-09T15:45:00+00:00"
}