Skip to main content
POST
/
customers
/
api
/
id-links
curl -X POST "https://api.trusset.org/customers/api/id-links" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "email": "[email protected]",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "country": "DE",
    "channels": ["email"]
  }'

{
  "success": true,
  "data": {
    "id": "link_abc123",
    "url": "https://verify.trusset.org/link_abc123",
    "status": "pending",
    "email": "[email protected]",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "createdAt": "2025-06-15T12:00:00.000Z",
    "expiresAt": "2025-06-22T12:00:00.000Z"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}
Creates a new identity verification link that can be sent to a customer to complete their KYC process. The link connects to the configured identity provider (e.g., Sumsub) and, upon successful completion, triggers the on-chain identity verification.

​
Request Body

The request body is passed directly to the ID link service. Required fields depend on the identity provider configuration for your instance.
​
email
string
Customer email address. Used to send the verification link.
​
walletAddress
string
Ethereum wallet address to associate with the verification.
​
country
string
ISO country code for the customer.
​
channels
string[]
Delivery channels for the link (e.g., ["email"], ["sms"], ["email", "sms"]).
​
metadata
object
Arbitrary metadata to attach to the link.

​
Response Fields

​
success
boolean
Request status
​
data
object
The created ID link object, including the generated link URL and its current status.
curl -X POST "https://api.trusset.org/customers/api/id-links" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "email": "[email protected]",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "country": "DE",
    "channels": ["email"]
  }'

{
  "success": true,
  "data": {
    "id": "link_abc123",
    "url": "https://verify.trusset.org/link_abc123",
    "status": "pending",
    "email": "[email protected]",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "createdAt": "2025-06-15T12:00:00.000Z",
    "expiresAt": "2025-06-22T12:00:00.000Z"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}