Aura Logo
AuraAPI Docs
OpenapiV1LeadsIdNotes

Add lead note

Append an internal note to a lead. The note is timestamped server-side and appears in the Aura dashboard immediately.

API-created notes carry no user_id (system-note semantics — same as the GraphQL leadAddNote mutation, which shares this append path).

Returns the lead's full notes array including the newly appended note.

POST
/v1/leads/{id}/notes

Path Parameters

idstring

Lead ID (UUID)

Formatuuid
contentstring

Note body. Plain text or markdown, 1-5000 characters. The API sets created_at server-side; API-created notes have no user_id (system-note semantics).

Length1 <= length <= 5000

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api.aura-app.ai/v1/leads/550e8400-e29b-41d4-a716-446655440000/notes" \  -H "Content-Type: application/json" \  -d '{    "content": "Follow up next week about pricing."  }'
{
  "data": {
    "notes": []
  },
  "success": true
}
{
  "code": "NOT_FOUND",
  "error": "Lead not found",
  "requestId": "req_abc123",
  "success": false
}
{
  "code": "NOT_FOUND",
  "error": "Lead not found",
  "requestId": "req_abc123",
  "success": false
}
{
  "code": "NOT_FOUND",
  "error": "Lead not found",
  "requestId": "req_abc123",
  "success": false
}