Custom data

curl -X POST https://api.nochurn.sh/v1/customers/user_123/attributes \
  -H "Authorization: Bearer $NOCHURN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"attributes":{"signup_source":"ads","onboarding_done":true,"seats":3,"activated_at":"2026-03-16"}}'

// user: { id, email, name }; attributes: e.g. { signup_source: "ads", onboarding_done: true }.
// Creates the customer (409 if it already exists: then updates it), then sends the attributes.
const NOCHURN_API_URL = process.env.NOCHURN_API_URL || "https://api.nochurn.sh";

async function nochurn(method, path, body) {
  const response = await fetch(`${NOCHURN_API_URL}${path}`, {
    method,
    headers: { Authorization: `Bearer ${process.env.NOCHURN_API_KEY}`, "Content-Type": "application/json" },
    body: body === undefined ? undefined : JSON.stringify(body),
  });
  const data = await response.json().catch(() => null);
  return { status: response.status, ok: response.ok, data };
}

export async function identifyCustomer(user, attributes) {
  const id = encodeURIComponent(String(user.id));
  const created = await nochurn("POST", "/v1/customers", { external_id: String(user.id), email: user.email, name: user.name });
  if (created.status === 409) {
    await nochurn("PATCH", `/v1/customers/${id}`, { email: user.email, name: user.name });
  } else if (!created.ok) {
    throw new Error(`NoChurn: ${created.data?.error?.message} ${created.data?.error?.fix ?? ""}`);
  }
  const result = await nochurn("POST", `/v1/customers/${id}/attributes`, { attributes });
  if (!result.ok) throw new Error(`NoChurn: ${result.data?.error?.message} ${result.data?.error?.fix ?? ""}`);
  return result.data;
}

import os
from urllib.parse import quote

import requests

NOCHURN_API_URL = os.environ.get("NOCHURN_API_URL", "https://api.nochurn.sh")


def _headers():
    return {"Authorization": f"Bearer {os.environ['NOCHURN_API_KEY']}", "Content-Type": "application/json"}


def _raise_for(response):
    if response.status_code >= 300:
        error = (response.json() or {}).get("error", {})
        raise RuntimeError(f"NoChurn: {error.get('message')} {error.get('fix', '')}")


def identify_customer(user, attributes):
    customer_id = quote(str(user["id"]), safe="")
    created = requests.post(f"{NOCHURN_API_URL}/v1/customers", headers=_headers(), timeout=10,
                            json={"external_id": str(user["id"]), "email": user.get("email"), "name": user.get("name")})
    if created.status_code == 409:
        requests.patch(f"{NOCHURN_API_URL}/v1/customers/{customer_id}", headers=_headers(), timeout=10,
                       json={"email": user.get("email"), "name": user.get("name")})
    else:
        _raise_for(created)
    response = requests.post(f"{NOCHURN_API_URL}/v1/customers/{customer_id}/attributes", headers=_headers(), timeout=10,
                             json={"attributes": attributes})
    _raise_for(response)
    return response.json()

require "net/http"
require "json"
require "uri"
require "erb"

def nochurn_request(method, path, body = nil)
  uri = URI("#{ENV.fetch('NOCHURN_API_URL', 'https://api.nochurn.sh')}#{path}")
  request = Net::HTTP.const_get(method.capitalize).new(uri)
  request["Authorization"] = "Bearer #{ENV.fetch('NOCHURN_API_KEY')}"
  request["Content-Type"] = "application/json"
  request.body = JSON.generate(body) if body
  response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(request) }
  [ response.code.to_i, (JSON.parse(response.body) rescue nil) ]
end

def identify_customer(user, attributes)
  id = ERB::Util.url_encode(user[:id].to_s)
  status, data = nochurn_request(:post, "/v1/customers", { external_id: user[:id].to_s, email: user[:email], name: user[:name] })
  if status == 409
    nochurn_request(:patch, "/v1/customers/#{id}", { email: user[:email], name: user[:name] })
  elsif status >= 300
    raise "NoChurn: #{data&.dig('error', 'message')} #{data&.dig('error', 'fix')}"
  end
  status, data = nochurn_request(:post, "/v1/customers/#{id}/attributes", { attributes: attributes })
  raise "NoChurn: #{data&.dig('error', 'message')} #{data&.dig('error', 'fix')}" if status >= 300

  data
end

curl -X POST https://api.nochurn.sh/v1/usage_events -H "Authorization: Bearer $NOCHURN_API_KEY" -H "Content-Type: application/json" -d '{"customer":"user_123","name":"project_created","properties":{"template":"blank"},"idempotency_key":"evt_42"}'