Skip to main content
POST
/
customers
/
api
/
manage
curl -X POST "https://api.trusset.org/customers/api/manage" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "country": "DE",
    "investorType": "PROFESSIONAL"
  }'

{
  "success": true,
  "data": {
    "id": "cust_abc123",
    "instanceId": "inst_xyz789",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "country": "DE",
    "investorType": "PROFESSIONAL",
    "status": "pending",
    "archived": false,
    "createdAt": "2025-06-15T12:00:00.000Z"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}
Creates a new customer record tied to the authenticated instance. The request body is passed to the customer service for validation and storage.

​
Request Body

​
walletAddress
string
required
Ethereum wallet address. Must be a valid checksummed or lowercased address.
​
country
string
required
ISO 3166-1 alpha-2 or alpha-3 country code (e.g., DE, DEU).
​
investorType
string
default:"RETAIL"
Investor classification. Values: RETAIL, PROFESSIONAL, INSTITUTIONAL.
​
email
string
Customer email address.
​
metadata
object
Arbitrary key-value metadata to store with the customer record.

​
Response Fields

​
success
boolean
Request status
​
data
object
The created customer object
curl -X POST "https://api.trusset.org/customers/api/manage" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "country": "DE",
    "investorType": "PROFESSIONAL"
  }'

{
  "success": true,
  "data": {
    "id": "cust_abc123",
    "instanceId": "inst_xyz789",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "country": "DE",
    "investorType": "PROFESSIONAL",
    "status": "pending",
    "archived": false,
    "createdAt": "2025-06-15T12:00:00.000Z"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}