Update a lead | Coi.co.il | API Documentation

curl -X PATCH https://www.your-store.co.il/api/v1/leads/1 \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "status": 6,
  "adminNotes": "חזרנו אליו, נשלחה הצעה"
}'

{
  "ok": true,
  "data": {
    "id": 1059,
    "createdAt": "2026-09-05T16:09:00+03:00",
    "name": "ישראל ישראלי",
    "email": "israel@example.com",
    "phone": "0501234567",
    "status": {
      "id": 1,
      "name": "חדש"
    },
    "newsletterOptIn": true,
    "page": "צור קשר",
    "fields": [
      {
        "name": "שם מלא",
        "key": "name",
        "value": "ישראל ישראלי"
      },
      {
        "name": "הודעה",
        "key": "message",
        "value": "אשמח להצעת מחיר"
      },
      {
        "name": "מאשר דיוור",
        "key": null,
        "value": true
      }
    ],
    "adminNotes": null
  }
}

Mark it handled, add notes. Requires leads:write.

Authentication

AuthorizationBearer

An API key from the store's admin: חנות > API ומפתחות. Send it as Authorization: Bearer coi_sk_... (or X-Api-Key: coi_sk_...). Never in the URL - ?apikey= is refused with 400.

Path parameters

idintegerRequired

Request

This endpoint expects an object.

statusintegerOptional1-6

adminNotesstring or nullOptional

Response

The updated lead.

oktrueOptional

dataobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error