Contacts API

# First page, default limit
curl "https://api.safravo.com/v1/contacts?limit=25&page=1" \
  -H "X-API-Key: saf_live_your_key"

# Search by name or phone
curl "https://api.safravo.com/v1/contacts?search=Jane&limit=10" \
  -H "X-API-Key: saf_live_your_key"

// Search
const { data } = await client.get('/v1/contacts', {
  params: { search: 'Jane', limit: 10 },
});

// Paginate through all contacts
async function fetchAllContacts() {
  const contacts = [];
  let page = 1;

  while (true) {
    const { data } = await client.get('/v1/contacts', {
      params: { page, limit: 100 },
    });
    contacts.push(...data.items);
    if (page >= data.totalPages) break;
    page++;
  }
  return contacts;
}

# Search
resp = client.get("/v1/contacts", params={"search": "Jane", "limit": 10})
resp.raise_for_status()
contacts = resp.json()["items"]

# Paginate all contacts
def fetch_all_contacts():
    page, results = 1, []
    while True:
        r = client.get("/v1/contacts", params={"page": page, "limit": 100})
        r.raise_for_status()
        body = r.json()
        results.extend(body["items"])
        if page >= body["totalPages"]:
            break
        page += 1
    return results

// Search
$contacts = Http::withHeaders(['X-API-Key' => env('SAFRAVO_API_KEY')])
    ->get('https://api.safravo.com/v1/contacts', [
        'search' => 'Jane',
        'limit'  => 10,
    ])
    ->json('items');

// Paginate all contacts
$page = 1;
$all  = [];
do {
    $response = Http::withHeaders(['X-API-Key' => env('SAFRAVO_API_KEY')])
        ->get('https://api.safravo.com/v1/contacts', ['page' => $page, 'limit' => 100]);
    $body = $response->json();
    $all  = array_merge($all, $body['items']);
    $page++;
} while ($page <= $body['totalPages']);

req, _ := http.NewRequest("GET", "https://api.safravo.com/v1/contacts", nil)
q := req.URL.Query()
q.Set("search", "Jane")
q.Set("limit", "10")
req.URL.RawQuery = q.Encode()
req.Header.Set("X-API-Key", os.Getenv("SAFRAVO_API_KEY"))

resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()

uri = URI('https://api.safravo.com/v1/contacts')
uri.query = URI.encode_www_form(search: 'Jane', limit: 10)

req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['SAFRAVO_API_KEY']

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
resp = http.request(req)
contacts = JSON.parse(resp.body)['items']

curl https://api.safravo.com/v1/contacts/6634e2b1a7c3f500231a8b01 \
  -H "X-API-Key: saf_live_your_key"

const { data } = await client.get(`/v1/contacts/${contactId}`);
console.log(data.phone);

resp = client.get(f"/v1/contacts/{contact_id}")
resp.raise_for_status()
contact = resp.json()

$contact = Http::withHeaders(['X-API-Key' => env('SAFRAVO_API_KEY')])
    ->get("https://api.safravo.com/v1/contacts/{$contactId}")
    ->json();

curl -X POST https://api.safravo.com/v1/contacts \
  -H "X-API-Key: saf_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Jane",
    "lastName": "Doe",
    "phone": "+254712345678",
    "email": "[email protected]",
    "company": "Acme Corp"
  }'

const { data } = await client.post('/v1/contacts', {
  firstName: 'Jane',
  lastName: 'Doe',
  phone: '+254712345678',
  email: '[email protected]',
  company: 'Acme Corp',
});

console.log('Created:', data.id);

resp = client.post("/v1/contacts", json={
    "firstName": "Jane",
    "lastName": "Doe",
    "phone": "+254712345678",
    "email": "[email protected]",
    "company": "Acme Corp",
})

if resp.status_code == 409:
    print("Contact already exists")
else:
    resp.raise_for_status()
    print("Created:", resp.json()["id"])

$response = Http::withHeaders(['X-API-Key' => env('SAFRAVO_API_KEY')])
    ->post('https://api.safravo.com/v1/contacts', [
        'firstName' => 'Jane',
        'lastName'  => 'Doe',
        'phone'     => '+254712345678',
        'email'     => '[email protected]',
        'company'   => 'Acme Corp',
    ]);

if ($response->status() === 409) {
    // Contact already exists — fetch by phone instead
} else {
    $contactId = $response->json('id');
}

payload, _ := json.Marshal(map[string]string{
    "firstName": "Jane",
    "lastName":  "Doe",
    "phone":     "+254712345678",
    "email":     "[email protected]",
})

req, _ := http.NewRequest("POST",
    "https://api.safravo.com/v1/contacts",
    bytes.NewBuffer(payload))
req.Header.Set("X-API-Key", os.Getenv("SAFRAVO_API_KEY"))
req.Header.Set("Content-Type", "application/json")

resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
// 201 → created, 409 → already exists

req = Net::HTTP::Post.new(URI('https://api.safravo.com/v1/contacts'))
req['X-API-Key'] = ENV['SAFRAVO_API_KEY']
req['Content-Type'] = 'application/json'
req.body = JSON.generate(
  firstName: 'Jane', lastName: 'Doe',
  phone: '+254712345678', email: '[email protected]'
)

resp = Net::HTTP.start('api.safravo.com', 443, use_ssl: true) { |h| h.request(req) }
puts resp.code  # "201" created, "409" duplicate

curl -X PATCH https://api.safravo.com/v1/contacts/6634e2b1a7c3f500231a8b01 \
  -H "X-API-Key: saf_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "company": "New Corp", "jobTitle": "CTO" }'

await client.patch(`/v1/contacts/${contactId}`, {
  company: 'New Corp',
  jobTitle: 'CTO',
});

client.patch(f"/v1/contacts/{contact_id}", json={
    "company": "New Corp",
    "jobTitle": "CTO",
}).raise_for_status()

Http::withHeaders(['X-API-Key' => env('SAFRAVO_API_KEY')])
    ->patch("https://api.safravo.com/v1/contacts/{$contactId}", [
        'company'  => 'New Corp',
        'jobTitle' => 'CTO',
    ]);