POST
/
v1
/
user
/
create
/
encrypted
curl --request POST \
  --url https://staging.terminal3.io/v1/user/create/encrypted \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: <x-api-token>' \
  --data '{
  "wallet": {
    "address": "<string>",
    "chain_id": "<string>"
  },
  "encrypted_profile": {
    "version": "<string>",
    "nonce": "<string>",
    "ephem_public_key": "<string>",
    "ciphertext": "<string>"
  }
}'
{
  "data": {
    "user_id": 123
  }
}

This API allows you to create a Terminal 3 user account based on an email or (optional) wallet address. User data will be securely stored in decentralized storage.

The UserProfile schema must adhere to the following format. Please ask us for more details on the validation rules for each field.

JSON
{
email_address: string;
first_name: string;
middle_name?: string;
last_name: string;
user_name?: string;
residence_country?: CountryOptions;
residence_province?: ProvinceOptions;
residence_city?: CityOptions;
mobile_number?: number;
mobile_country_code?: string;
gender?: GenderOptions;
date_of_birth?: string;
language_primary?: LanguageOptions;
language_others?: LanguageOptions;
employment_status?: EmploymentStatusOptions;
employment_industry?: EmploymentIndustryOptions;
marital_status?: MaritalStatusOptions;
education?: EducationOptions;
household_income?: HouseholdIncomeOptions;
}

We also provide an SDK with a function called makeEncryptedUserMsg to encrypt the user profile with our public key, please contact us for more details.

JavaScript
import { makeEncryptedUserMsg } from "@terminal3/messaging_client";

const t3PublicKey = "b/fo6+4q2FpC0X5Tv32I7s4uT1yaGPPgClsTztVw+UY=";

const encryptedMsg = makeEncryptedUserMsg(
  {
    first_name: "Michael",
    last_name: "Dowsen",
    email_address: "michael_dowsen@gmail.com",
  },
  t3PublicKey,
  true
);

console.log(JSON.stringify(encryptedMsg));

Example input payload:

JSON
{
  "wallet": {
    "address": "0x2EF2922885EDcf2151f6C863e58adcEc70c11356",
    "chain_id": "1"
  },
  "encrypted_profile": {
    "version": "x25519-xsalsa20-poly1305",
    "nonce": "j85PmoUS+XCR79RBnZpY68imEtluKK1t",
    "ephem_public_key": "ZYAFFnmvyt55Q8dhZ2vpVcp5LXS572/oWrMTFMJ+jhc=",
    "ciphertext": "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"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-api-token
string
required
​
x-api-subclient-id
string

Body

application/json
​
encrypted_profile
object
required
​
wallet
object

Response

200
application/json
Success
​
data
object
required