Add a note

curl --request POST \
  --url https://backend.leadey.ai/v1/leads/{id}/notes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "Asked for pricing on a 240-vehicle fleet. Sending the sheet Thursday."
}
'

import requests

url = "https://backend.leadey.ai/v1/leads/{id}/notes"

payload = { "text": "Asked for pricing on a 240-vehicle fleet. Sending the sheet Thursday." }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({text: 'Asked for pricing on a 240-vehicle fleet. Sending the sheet Thursday.'})
};

fetch('https://backend.leadey.ai/v1/leads/{id}/notes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "id": "event_6Tk9wRmB",
    "type": "note",
    "outcome": null,
    "stepIndex": 0,
    "meta": {
      "text": "Left a voicemail. Trying again Thursday morning.",
      "userId": "user_2pXn4Rk"
    },
    "timestamp": "2026-08-03T11:09:20.000Z"
  }
}

{
  "error": {
    "message": "One of email, phone or linkedinUrl is required",
    "details": null
  }
}

{
  "error": {
    "message": "Invalid or revoked API key.",
    "details": null
  }
}

{
  "error": {
    "message": "This API key is read-only. Create a key with write access in Settings → API Keys.",
    "details": null
  }
}

{
  "error": {
    "message": "Lead not found",
    "details": null
  }
}

{
  "error": {
    "message": "Rate limit exceeded. Retry in 42s.",
    "details": null
  }
}