Leads

Push Lead

Add a prospect. A lead with the same phone is updated instead (answered 200).

POST https://rassmi.com/api/v1/leads

Authorization

Authorizationheaderrequired

Bearer rsk_…: the store's API key, from API Key in your Rassmi dashboard.

Body

name string required

Up to 255 characters.
phone string required

Identifies the lead in the store.
email string

An email address.
wilaya string

Wilaya code or name.
commune string

Commune ID or name.
address string

Up to 500 characters.
notes string

Up to 1,000 characters.

Responses

Status	Meaning
`201`	Success. The body is shown on the right.
`422`	Validation failed.
`401`	Missing, unknown, paused or expired API key.
`429`	More than 60 requests in a minute. See Rate limits.

POST /leads

curl -X POST "https://rassmi.com/api/v1/leads" \
  -H "Authorization: Bearer $RASSMI_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Karim Haddad",
    "phone": "0661234567",
    "wilaya": "Oran"
}'

use Illuminate\Support\Facades\Http;

$response = Http::withToken(env('RASSMI_API_KEY'))
    ->acceptJson()
    ->post('https://rassmi.com/api/v1/leads', [
        'name' => 'Karim Haddad',
        'phone' => '0661234567',
        'wilaya' => 'Oran',
    ]);

$data = $response->json();

const response = await fetch('https://rassmi.com/api/v1/leads', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.RASSMI_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "name": "Karim Haddad",
      "phone": "0661234567",
      "wilaya": "Oran"
  }),
});

const data = await response.json();

import os
import requests

response = requests.request(
    "POST",
    "https://rassmi.com/api/v1/leads",
    headers={"Authorization": f"Bearer {os.environ['RASSMI_API_KEY']}"},
    json={
        "name": "Karim Haddad",
        "phone": "0661234567",
        "wilaya": "Oran",
    },
)

data = response.json()

Response · 201

{
    "data": {
        "id": 5521,
        "name": "Karim Haddad",
        "phone": "0661234567",
        "email": null,
        "wilaya": "31",
        "commune": null,
        "address": null,
        "status": "new",
        "notes": null,
        "created_at": "2026-10-30T08:02:19+00:00"
    }
}