> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# إنشاء قائمة عملاء محتملين

> POST /lead/

قوائم العملاء المحتملين (Lead Lists) هي ميزة التقاط العملاء المحتملين الأصلية في Scanova — تعريف نموذج (`data`) مُرفق بصفحة هبوط رمز QR. اسردها أو أنشئها هنا.

<Warning>
  قوائم العملاء المحتملين ميزة **قديمة**. لوحة تحكم Scanova توجّه الآن حالات استخدام التقاط العملاء المحتملين الجديدة نحو [النماذج](/ar/api-reference/management-api/forms/create) بدلًا منها، والتي تغطي حالة الاستخدام نفسها "جمع بيانات الزوار من مسح رمز QR" بأداة بناء أكثر قدرة. قوائم العملاء المحتملين الحالية تستمر في العمل، ونقطة النهاية هذه غير متأثرة، لكن ابنِ عمليات تكامل جديدة على أساس النماذج ما لم تكن بحاجة تحديدًا إلى إدارة قائمة عملاء محتملين موجودة مسبقًا.
</Warning>

<Note>
  يتطلب مفتاح Management API بحصة `MANAGEMENT_API` (أو `MANAGEMENT_API_SANDBOX`)، يُرسل كقيمة خام لترويسة `Authorization` — راجع [نظرة عامة على Management API](/ar/api-reference/management-api/overview).
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://management.scanova.io/lead/' \
    --header 'Authorization: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "name": "Trade Show Signup",
      "data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": 205,
    "lead_id": "L9c2f4a1e",
    "name": "Trade Show Signup",
    "created": "2026-08-16T20:44:51.008000+05:30",
    "is_active": true,
    "usage_count": 0,
    "entries_count": 0,
    "linked_qrs": [],
    "modified": "2026-08-16T20:44:51.008000+05:30",
    "data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}",
    "webhooks": []
  }
  ```
</ResponseExample>

<ParamField body="name" type="string" required>
  اسم قائمة العملاء المحتملين، حتى 128 حرفًا.
</ParamField>

<ParamField body="data" type="string" required>
  سلسلة نصية مُرمَّزة بصيغة JSON (وليست كائنًا خامًا) تصف حقول نموذج العملاء المحتملين. تُتحقق من صحتها مقابل مخطط نموذج العملاء المحتملين نفسه الذي تستخدمه أداة بناء قوائم العملاء المحتملين في لوحة التحكم — JSON غير صالح أو مخالفة للمخطط تعيد 400 تحت `data`.
</ParamField>

<ParamField body="is_active" type="boolean" default="true">
  ما إذا كان النموذج يُعرض على صفحة الهبوط.
</ParamField>

<Note>
  تتضمن الاستجابة `data` و`webhooks` (قائمة من إشعارات webhook بصيغة `{id, url, created, modified}`) — حقول موجودة فقط في شكل التفاصيل الذي يعيده الإنشاء/الاسترجاع، وليس في نقطة نهاية السرد أعلاه.
</Note>

## ذات صلة

* [سرد قوائم العملاء المحتملين](/ar/api-reference/management-api/leads/list) — العملية الأخرى لنفس نقطة النهاية هذه.
* [إدارة النماذج](/ar/api-reference/management-api/forms/create) — أداة بناء التقاط العملاء المحتملين الحالية والموصى بها التي يُوجَّه إليها استخدام هذه الميزة القديمة.
* [نظرة عامة على Management API](/ar/api-reference/management-api/overview) — مخطط المصادقة وبنية الحصص التي تنتمي إليها نقطة النهاية هذه.


## OpenAPI

````yaml api-reference/openapi/management-api.json POST /lead/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    management.scanova.io (QR codes, folders, tags, leads, forms, analytics,
    plans, shared users & roles), plus the token-creation and usage-stats
    endpoints used to authenticate against it. Every path and request/response
    shape below was verified live against a real API key and the actual running
    backend (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
  version: 2.0.0
servers:
  - url: https://management.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /lead/:
    post:
      summary: Create a lead list
      operationId: createManagedLeadList
      responses:
        '201':
          description: Lead list created
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Send your Management API key as the raw value of the Authorization
        header — no "Bearer " or "Token " prefix, and no other characters.
        Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
        header containing more than one space-separated part is rejected
        outright. Requests also require the request's Host header to be the
        management API host (e.g. management.scanova.io) — the same key sent to
        the regular API host will not authenticate.

````