POST /v1/customers — Create or Retrieve Customer

curl -X POST https://api.gateway.accelebit.com/v1/customers \
  -H "Content-Type: application/json" \
  -H "X-API-Key: smtgw_sk_test_your_secret_key" \
  -H "Idempotency-Key: cust_abc123" \
  -d '{
    "externalId": "user_12345",
    "email": "jane@example.com",
    "metadata": {
      "plan": "premium"
    }
  }'

const response = await fetch('https://api.gateway.accelebit.com/v1/customers', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': process.env.ACCELEBIT_SECRET_KEY!,
    'Idempotency-Key': `cust_${crypto.randomUUID()}`,
  },
  body: JSON.stringify({
    externalId: 'user_12345',
    email: 'jane@example.com',
    metadata: { plan: 'premium' },
  }),
});

const result = await response.json();

import requests
import uuid

response = requests.post(
    'https://api.gateway.accelebit.com/v1/customers',
    headers={
        'Content-Type': 'application/json',
        'X-API-Key': ACCELEBIT_SECRET_KEY,
        'Idempotency-Key': f'cust_{uuid.uuid4()}',
    },
    json={
        'externalId': 'user_12345',
        'email': 'jane@example.com',
        'metadata': {'plan': 'premium'},
    },
)

result = response.json()

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "externalId": "user_12345",
    "email": "jane@example.com",
    "metadata": {
      "plan": "premium"
    },
    "createdAt": "2026-04-09T12:00:00.000Z"
  }
}

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "externalId": "user_12345",
    "email": "jane@example.com",
    "metadata": {
      "plan": "premium"
    },
    "createdAt": "2026-04-08T10:00:00.000Z"
  }
}