বিষয়বস্তু এড়িয়ে যান

API রেফারেন্স

নেতৃত্ব দেয়

পরিচিতি এবং গ্রাহকদের. সৃষ্টি সদৃশ নয়: একই ইমেল বা টেলিফোন নম্বর আগে থেকেই বিদ্যমান লিড ফেরত দেয়।

Listar leads

get/api/v1/leads

মূল অনুমতি: leitura

পরামিতি

limit integer · consulta

ডিফল্ট: 50 · Máximo: 200

cursor string · consulta

next_cursor da página anterior

updated_since string (date-time) · consulta

—

status string · consulta

—

উত্তর

  • 200Página de leads
অনুরোধ
curl "https://www.cyzyra.com/api/v1/leads" \
  -H "Authorization: Bearer $CYZYRA_API_KEY"
প্রতিক্রিয়া
{
  "data": [
    {
      "id": "8f1c…",
      "name": "Ana Souza",
      "email": "ana@example.com",
      "status": "new",
      "created_at": "2026-11-08T14:02:11Z"
    }
  ],
  "next_cursor": "eyJ0Ijoi…"
}

說明性範例。

Criar lead (sem duplicar: e-mail/telefone iguais devolvem o existente)

post/api/v1/leads

মূল অনুমতি: escrita

বডি (JSON)

name stringবাধ্যতামূলক

—

email string

—

phone string

—

whatsapp string

—

city string

—

country string

উদাহরণ: "BR"

notes string

—

source_detail string

—

tags string[]

—

উত্তর

  • 200Já existia (duplicate: true)
  • 201Criado
অনুরোধ
curl -X POST "https://www.cyzyra.com/api/v1/leads" \
  -H "Authorization: Bearer $CYZYRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Ana Souza","email":"ana@example.com","whatsapp":"+5511999990000","country":"BR","tags":["site"]}'
প্রতিক্রিয়া
{
  "data": {
    "id": "8f1c…",
    "name": "Ana Souza",
    "status": "new"
  },
  "created": true,
  "duplicate": false
}

說明性範例。

Ver lead

get/api/v1/leads/{id}

মূল অনুমতি: leitura

পরামিতি

id string (uuid) · caminhoবাধ্যতামূলক

—

উত্তর

  • 200সীসা
  • 404Não encontrado
অনুরোধ
curl "https://www.cyzyra.com/api/v1/leads/LEAD_ID" \
  -H "Authorization: Bearer $CYZYRA_API_KEY"
প্রতিক্রিয়া
{
  "data": {
    "id": "8f1c…",
    "name": "Ana Souza",
    "email": "ana@example.com",
    "status": "new"
  }
}

說明性範例。

Alterar lead

patch/api/v1/leads/{id}

মূল অনুমতি: escrita

পরামিতি

id string (uuid) · caminhoবাধ্যতামূলক

—

বডি (JSON)

name string

—

email string

—

phone string

—

city string

—

status string

—

tags string[]

—

notes string

—

do_not_contact boolean

—

উত্তর

  • 200Lead atualizado
অনুরোধ
curl -X PATCH "https://www.cyzyra.com/api/v1/leads/LEAD_ID" \
  -H "Authorization: Bearer $CYZYRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"Curitiba","tags":["vip"]}'
প্রতিক্রিয়া
{
  "data": {
    "id": "8f1c…",
    "city": "Curitiba",
    "tags": [
      "vip"
    ]
  }
}

說明性範例。