# Export KINTRA_API for your environment first; the base URL is on the introduction page.
KEY="YOUR_TENANT_KEY_ID"
SECRET="YOUR_SIGNING_SECRET"

# The signature covers the path and query exactly as sent, so both are split
# off the base URL and reused for the request line below.
API_PATH="/${KINTRA_API#*://*/}"
API_HOST="${KINTRA_API%"$API_PATH"}"
METHOD="POST"
PATH_AND_QUERY="$API_PATH/gateway/customers"

# One compact line, signed and sent unchanged. The server signs a
# re-serialization of the body it parsed, so reformatting this fails with a 401.
BODY='{"email":"YOUR_EMAIL"}'

TIMESTAMP="$(date +%s)"
SIGNATURE="$(printf '%s' "$TIMESTAMP$METHOD$PATH_AND_QUERY$BODY" \
  | openssl dgst -sha256 -hmac "$SECRET" | awk '{print $NF}')"

curl -sS -w '\n%{http_code}' -X "$METHOD" "$API_HOST$PATH_AND_QUERY" \
  -H "X-Tenant-Key: $KEY" \
  -H "X-Tenant-Timestamp: $TIMESTAMP" \
  -H "X-Tenant-Signature: $SIGNATURE" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: YOUR_IDEMPOTENCY_KEY" \
  --data-binary "$BODY"

const options = {
  method: 'POST',
  headers: {
    'X-Tenant-Signature': '<x-tenant-signature>',
    'X-Tenant-Timestamp': '<x-tenant-timestamp>',
    'X-Idempotency-Key': '<x-idempotency-key>',
    'x-tenant-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: '<string>',
    attributes: {},
    cohort: {club_ids: ['<string>'], country_id: '<string>', metadata: {}},
    first_name: '<string>',
    last_name: '<string>'
  })
};

fetch('https://api.kintra.io/api/v1/gateway/customers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.kintra.io/api/v1/gateway/customers"

payload = {
    "email": "<string>",
    "attributes": {},
    "cohort": {
        "club_ids": ["<string>"],
        "country_id": "<string>",
        "metadata": {}
    },
    "first_name": "<string>",
    "last_name": "<string>"
}
headers = {
    "X-Tenant-Signature": "<x-tenant-signature>",
    "X-Tenant-Timestamp": "<x-tenant-timestamp>",
    "X-Idempotency-Key": "<x-idempotency-key>",
    "x-tenant-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "auth_provider": "<string>",
    "auth_provider_id": "<string>",
    "email": "<string>",
    "id": "<string>",
    "status": "<string>",
    "username": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "first_name": "<string>",
    "internal_wallets": [
      {
        "address": "<string>",
        "id": "<string>",
        "user_id": "<string>",
        "wallet_kind": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "deleted_at": "2023-11-07T05:31:56Z",
        "label": "<string>",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "last_name": "<string>",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "errors": [
    {
      "message": "<string>",
      "path": "<string>"
    }
  ],
  "message": "<string>"
}

{
  "success": true,
  "data": {
    "auth_provider": "<string>",
    "auth_provider_id": "<string>",
    "email": "<string>",
    "id": "<string>",
    "status": "<string>",
    "username": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "first_name": "<string>",
    "internal_wallets": [
      {
        "address": "<string>",
        "id": "<string>",
        "user_id": "<string>",
        "wallet_kind": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "deleted_at": "2023-11-07T05:31:56Z",
        "label": "<string>",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "last_name": "<string>",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "errors": [
    {
      "message": "<string>",
      "path": "<string>"
    }
  ],
  "message": "<string>"
}

{
  "success": true,
  "data": null,
  "errors": [
    {
      "message": "<string>",
      "path": "<string>"
    }
  ],
  "message": "<string>"
}

{
  "success": true,
  "data": null,
  "errors": [
    {
      "message": "<string>",
      "path": "<string>"
    }
  ],
  "message": "<string>"
}

{
  "success": true,
  "data": null,
  "errors": [
    {
      "message": "<string>",
      "path": "<string>"
    }
  ],
  "message": "<string>"
}

{
  "success": true,
  "data": null,
  "errors": [
    {
      "message": "<string>",
      "path": "<string>"
    }
  ],
  "message": "<string>"
}