Leads

Push raw lead details for immediate agent call dispatching.

POST /api/v1/leads Push Lead

Push a new lead from your landing page or external form. If a lead with the same phone number already exists, it is updated. The lead is immediately queued for agent call assignment.

Request Body

{
  "name": "Youcef Benali",
  "phone": "+213661234567",
  "email": "youcef@email.com",
  "wilaya": "19",
  "commune": "1901",
  "address": "Cité El Hidhab"
}

curl -X POST 'https://rassmi.com/api/v1/leads' \
  -H 'Authorization: Bearer rsk_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Youcef Benali","phone":"+213661234567","wilaya":"19","commune":"1901"}'

$client->post('/api/v1/leads', [
    'headers' => ['Authorization' => 'Bearer rsk_your_key'],
    'json'    => ['name' => 'Youcef Benali', 'phone' => '+213661234567', 'wilaya' => '19', 'commune' => '1901'],
]);

await fetch('/api/v1/leads', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer rsk_your_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ name: 'Youcef Benali', phone: '+213661234567', wilaya: '19', commune: '1901' }),
});

Http::withToken('rsk_your_key')
->post('/api/v1/leads', [
        'name'    => 'Youcef Benali',
        'phone'   => '+213661234567',
        'wilaya'  => '19',
        'commune' => '1901',
    ]);

Response 201 / 200

{
  "name": "Youcef Benali",
  "phone": "+213661234567",
  "wilaya": "19",
  "commune": "1901",
  "status": "customer",
  "created_at": "2026-08-02T19:00:00Z"
}

Returns 201 for new leads and 200 for updated existing ones. It is recommended to send wilaya and commune in numeric format (e.g. "19" for Sétif). Text names (e.g. "Sétif") are also accepted and parsed to numbers automatically.