Skip to main content

​
Prerequisites

  • An API key (contact [email protected] to request one)
  • A tool to make HTTP requests (cURL, Postman, or your preferred language)

​
Your First API Call

Upload a customer record to get started: 
curl -X POST https://api.hellocobi.com/v1/data/customers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      {
        "customer_id": "550e8400-e29b-41d4-a716-446655440000",
        "user_id": "550e8400-e29b-41d4-a716-446655440001",
        "region": "US",
        "birthdate": "1990-01-01",
        "gender": "MALE"
      }
    ]
  }'
A successful response: 
{
  "status": "success",
  "message": "Records uploaded successfully",
  "count": 1
}

​
Available Endpoints

Once you’re uploading successfully, explore the full set of endpoints:

​
Best Practices

Send up to 5,000 records per request for the best throughput. Before uploading at scale, check your payload against the data models to catch schema errors early. Always check the response status on each request and retry with exponential backoff on 429 or 5xx responses.

​
Next Steps

  • Read the Authentication guide for API key security and error codes
  • Browse the Data Models to see required and optional fields for each record type
  • Check out the Recommendations API to surface personalised offers for your users