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",
    "name": "Acme Corp",
    "country": "DE",
    "investorType": "PROFESSIONAL"
  }'

{
  "success": true,
  "data": {
    "id": "cust_abc123",
    "instanceId": "inst_xyz789",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "referenceKey": null,
    "name": "Acme Corp",
    "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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.trusset.org/llms.txt

Use this file to discover all available pages before exploring further.

Creates a new customer record tied to the authenticated instance. You can either provide a wallet address directly, or omit it to receive a referenceKey that allows linking a wallet later via the Link Wallet endpoint.

​
Request Body

​
walletAddress
string
Ethereum wallet address. Must be a valid checksummed or lowercased address. If omitted, a referenceKey is generated for deferred wallet linking.
​
name
string
Customer display name.
​
country
string
ISO 3166-1 alpha-2 or alpha-3 country code (e.g., DE, DEU).
​
investorType
string
default:"RETAIL"
Investor classification. Values: RETAIL, PROFESSIONAL, ELIGIBLE_COUNTERPARTY.
​
externalId
string
Your own external reference identifier for this customer.
​
metadata
object
Arbitrary key-value metadata to store with the customer record.

​
Response Fields

​
success
boolean
Request status
​
data
object
The created customer object. Includes referenceKey when no walletAddress was provided.
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",
    "name": "Acme Corp",
    "country": "DE",
    "investorType": "PROFESSIONAL"
  }'

{
  "success": true,
  "data": {
    "id": "cust_abc123",
    "instanceId": "inst_xyz789",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "referenceKey": null,
    "name": "Acme Corp",
    "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"
  }
}