Trustcrow API v1
  • Introduction
  • Authentication
  • Errors
  • API Reference
    • User Management
      • Create a user
      • Fetch users
      • Fetch user's wallet
    • Transaction
      • Create a transaction
      • Fetch transactions
      • Fetch milestones
      • Fund milestone
      • Deliver item
      • Accept item delivery
      • Reject item delivery
      • Approve returned item
      • Disapprove returned item
    • Dispute Management
      • Create a dispute
      • Fetch dispute
      • Add dispute amount
      • Approve dispute amount
      • Disapprove dispute amount
    • Disbursement
    • Other tools
      • Bank verification
      • File Upload
Powered by GitBook
On this page
  • Create a new user
  • cURL Request

Was this helpful?

  1. API Reference
  2. User Management

Create a user

Creating a new customer on Trustcrow is quite straight forward. The minimal amount of information required are the customers first name, last name and email address.

You are only able to create customers where their email address is not already in use. Creating an account for a user that already exists will result in an error, and an HTTP 403 will be returned. Once a customer has been created, either through the API or if they've signed up themselves, their information can no longer be created by API integrations.

Create a new user

POST {{api_url}}/v1/users

Headers

Name
Type
Description

Accepts

string

application/json

Authorization

string

your Trustcrow API keys with which you authorize customers.

Request Body

Name
Type
Description

first_name

String

The first name of the customer

last_name

String

The last name of the customer

email_address

String

The email address of the customer

{
    "status": true,
    "message": "Account created successfully",
    "data": {
        "first_name": "Haleemah",
        "last_name": "Opeyemi",
        "email": "haleemahfolag@yopmail.com",
        "default_email": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1_haleemahfolag@yopmail.com",
        "clientId": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
        "password_created": false,
        "user_name": "haopho31079",
        "is_account_verified": true,
        "source": "THIRD_PARTY",
        "phone": null,
        "referredById": null,
        "referral_code": null,
        "public_key": null,
        "secret_key": null,
        "last_logged_in_at": null,
        "id": "369ea20c-212b-4b2a-9f87-31c7b11dec58",
        "password_reset": false,
        "role": "USER",
        "api_enabled": false,
        "created_at": "2023-12-26T09:03:18.766Z",
        "updated_at": "2023-12-26T09:03:18.766Z",
        "wallet": {
            "name": "Haleemah Opeyemi's Wallet",
            "account_reference": "TRC_ACC_YST1LVV9HXCIQBPR",
            "provider": "MONNIFY",
            "funder_email": null,
            "disbursement_email": null,
            "bvn": null,
            "paystack_provider_account_properties": null,
            "monnify_provider_account_properties": null,
            "id": "b78ec8db-4bab-43c3-84a1-a9d55d036d54",
            "balance": 0,
            "created_at": "2023-12-26T09:03:18.788Z",
            "updated_at": "2023-12-26T09:03:18.788Z"
        }
    }
}

cURL Request

curl --location 'http://trustcrow-api-sandbox.us-east-1.elasticbeanstalk.com/v1/users' \
--header 'Content-Type: application/json' \
--header 'Authorization: SECRET_KEY' \
--data-raw '{
    "email": "joe@yopmail.com",
    "first_name": "John",
    "last_name": "Doe"
}'

Note:

  • To successfully create a customer, you must first create a wallet and complete KYC. Failure to do so will result in a bad request response upon attempting to create the customer.

  • Upon successful creation of a customer, the system automatically generates a wallet for that customer.

PreviousUser ManagementNextFetch users

Last updated 1 year ago

Was this helpful?