curl https://api.kwugwo.africa/v1/onye \
  -H "Authorization: Bearer $KWUGWO_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "ref": "user_8821",
    "first_name": "Ada",
    "last_name": "Okeke",
    "billing_address": {
      "address": "12 Marina",
      "address2": "",
      "city": "Lagos",
      "state": "Lagos",
      "zip": "101001",
      "country": "NG"
    },
    "meta": { "source": "shopify" }
  }'

const onye = await fetch("https://api.kwugwo.africa/v1/onye", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    email: "ada@example.com",
    ref: "user_8821",
    first_name: "Ada",
    last_name: "Okeke",
  }),
}).then(r => r.json());

<?php
$ch = curl_init("https://api.kwugwo.africa/v1/onye");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('KWUGWO_SECRET_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'email'      => 'ada@example.com',
        'ref'        => 'user_8821',
        'first_name' => 'Ada',
        'last_name'  => 'Okeke',
    ]),
]);
$onye = json_decode(curl_exec($ch), true);
curl_close($ch);

import os, requests

onye = requests.post(
    "https://api.kwugwo.africa/v1/onye",
    headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
    json={
        "email": "ada@example.com",
        "ref": "user_8821",
        "first_name": "Ada",
        "last_name": "Okeke",
    },
).json()

body, _ := json.Marshal(map[string]any{
    "email":      "ada@example.com",
    "ref":        "user_8821",
    "first_name": "Ada",
    "last_name":  "Okeke",
})
req, _ := http.NewRequest("POST", "https://api.kwugwo.africa/v1/onye", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("KWUGWO_SECRET_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

{
  "uid": "ony.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Okeke",
  "nzube_ref": "user_8821",
  "billing_address": {
    "address": "12 Marina",
    "address2": "",
    "city": "Lagos",
    "state": "Lagos",
    "zip": "101001",
    "country": "NG"
  },
  "created_at": "2026-05-15T09:14:22+00:00",
  "updated_at": "2026-05-15T09:14:22+00:00",
  "meta": { "source": "shopify" },
  "total_successful_activities": 0,
  "total_failed_activities": 0,
  "latest_ugwo_activity": null
}

{
  "message": "nzube.onye.error.already_exists",
  "code": "already_exists",
  "params": []
}