Get User ID

Before creating a withdrawal, you need a user_id in the Tonder system. This endpoint allows you to get or create a user ID.

Authentication RequiredThis endpoint requires authentication. Include the Authorization header with your API token in every request. See Authentication requirements for details.

Endpoint

POST /customer/

Request Body

Parameter	Type	Required	Description
`email`	string	Yes	Customer email address
`first_name`	string	Yes	Customer first name
`last_name`	string	Yes	Customer last name
`phone`	string	Yes	Customer phone number

Request Example

{
  "email": "testidcustomer@testuser.com",
  "first_name": "Paco",
  "last_name": "Fernandez",
  "phone": "8161234567"
}

Response

The API returns the user information including the id and auth_token:

{
  "id": 6165,
  "email": "testidcustomer@testuser.com",
  "auth_token": "fa2a7cbcbbcb6d00e745651c6e21fd6cc5c6a26b",
  "first_name": "Paco",
  "last_name": "Fernandez"
}

Save the User IDSave the id field from the response. You’ll need this user_id when creating withdrawal requests.

cURL Example

curl -X POST https://stage.tonder.io/api/v1/customer/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "testidcustomer@testuser.com",
    "first_name": "Paco",
    "last_name": "Fernandez",
    "phone": "8161234567"
  }'

Postman UsersIn Postman, add the Authorization header manually:

Key: Authorization
Value: Token YOUR_API_KEY (replace with your actual token from the Developers section)

Replace YOUR_API_KEY with the token provided in the Developers section of the Tonder platform.

Next Steps

Use the returned id as the user_id when creating a withdrawal
Learn about authentication requirements

Introduction

Core Concepts

Endpoint

Request Body

Request Example

Response

cURL Example

Next Steps

​Endpoint

​Request Body

​Request Example

​Response

​cURL Example

​Next Steps

Endpoint

Request Body

Request Example

Response

cURL Example

Next Steps