Learn how to manage your clients and reseller accounts via API.
Unfortunately, our reseller dashboard, white-label and reseller API are only available to customers who were approved as resellers before 1st Jan, 2024. If you were not approved as a reseller before 1st Jan, 2024, you may still earn profits by adding a mark-up on your client rates when reselling ClickSend through our standard messaging endpoints.
Get list of reseller accounts
Parameter | In | Type | Required | Description |
---|---|---|---|---|
page | query | integer(int32) | false | Page number |
limit | query | integer(int32) | false | Number of records per page |
Refer to Status Codes for definitions of HTTP status code responses.
https://rest.clicksend.com/v3/reseller/accounts
curl --include \
--header "Authorization: Basic YXBpLXVzZXJuYW1lOmFwaS1wYXNzd29yZA==" \
'https://rest.clicksend.com/v3/reseller/accounts'
{ "http_code": 200, "response_code": "SUCCESS", "response_msg": "Here are you data.", "data": { "total": 2, "per_page": 15, "current_page": 1, "last_page": 1, "next_page_url": null, "prev_page_url": null, "from": 1, "to": 2, "data": [ … ], "_currency": { … }, "_subaccount": { … } } }
Create reseller account
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
username | string | true | none | Account username |
password | string | true | none | Account password (unhashed) |
user_email | string | true | none | Account email |
user_phone | string | true | none | Account phone number |
user_first_name | string | true | none | Account owner first name |
user_last_name | string | true | none | Account owner last name |
account_name | string | true | none | Account name (usually company name) |
country | string | true | none | Country of account holder |
Refer to Status Codes for definitions of HTTP status code responses.
https://rest.clicksend.com/v3/reseller/accounts
curl --include \
--header "Authorization: Basic YXBpLXVzZXJuYW1lOmFwaS1wYXNzd29yZA==" \
--request POST \
--header "Content-Type: application/json" \
--data-binary " {
\"username\":\"johndoe2\",
\"user_email\":\"johndoe2@awesome.com\",
\"user_phone\":\"518-481-1002\",
\"user_first_name\":\"John\",
\"user_last_name\":\"Doe\",
\"country\":\"US\",
\"password\":\"pass\",
\"account_name\":\"The Awesome Company\"
}" \
'https://rest.clicksend.com/v3/reseller/accounts'
{ "http_code": 200, "response_code": "SUCCESS", "response_msg": "New reseller has been added.", "data": { "user_id": 117, "username": "johndoe2", "user_email": "johndoe2@awesome.com", "active": 0, "banned": 0, "balance": "0.000000", "user_phone": 15184811002, "reply_to": "originalemail", "delivery_to": null, "user_first_name": "John", "user_last_name": "Doe", "account": 0, "account_name": "The Awesome Company", "account_billing_email": "johndoe2@awesome.com", "account_billing_mobile": 15184811002, "country": "US", "default_country_sms": "US", "auto_recharge": 0, "auto_recharge_amount": "20.00", "low_credit_amount": "0.00", "setting_unicode_sms": 0, "setting_email_sms_subject": 0, "setting_fix_sender_id": 0, "setting_sms_message_char_limit": 6, "old_dashboard": 0, "balance_commission": "0.299954", "timezone": "Australia/Melbourne", "_currency": { … }, "_subaccount": { … } } }
Get Reseller clients Account
Parameter | In | Type | Required | Description |
---|---|---|---|---|
client_user_id | path | integer(int32) | true | User ID of client |
Refer to Status Codes for definitions of HTTP status code responses.
https://rest.clicksend.com/v3/reseller/accounts/{client_user_id}
curl --include \
--header "Authorization: Basic YXBpLXVzZXJuYW1lOmFwaS1wYXNzd29yZA==" \
'https://rest.clicksend.com/v3/reseller/accounts/{client_user_id}'
{ "http_code": 200, "response_code": "SUCCESS", "response_msg": "Here are your data.", "data": { "user_id": 117, "username": "johndoe2", "user_email": "johndoe2@awesome.com", "active": 0, "banned": 0, "balance": "0.000000", "user_phone": 15184811002, "reply_to": "originalemail", "delivery_to": null, "user_first_name": "John", "user_last_name": "Doe", "account": 0, "account_name": "The Awesome Company", "account_billing_email": "johndoe2@awesome.com", "account_billing_mobile": 15184811002, "country": "US", "default_country_sms": "US", "auto_recharge": 0, "auto_recharge_amount": "20.00", "low_credit_amount": "0.00", "setting_unicode_sms": 0, "setting_email_sms_subject": 0, "setting_fix_sender_id": 0, "setting_sms_message_char_limit": 6, "old_dashboard": 0, "balance_commission": "0.299954", "timezone": "Australia/Melbourne", "_currency": { … }, "_subaccount": { … } } }
Update Reseller clients Account
Parameter | In | Type | Required | Description |
---|---|---|---|---|
client_user_id | path | integer(int32) | true | User ID of client |
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
username | string | true | none | Account username |
password | string | true | none | Account password (unhashed) |
user_email | string | true | none | Account email |
user_phone | string | true | none | Account phone number |
user_first_name | string | true | none | Account owner first name |
user_last_name | string | true | none | Account owner last name |
account_name | string | true | none | Account name (usually company name) |
country | string | true | none | Country of account holder |
Refer to Status Codes for definitions of HTTP status code responses.
https://rest.clicksend.com/v3/reseller/accounts/{client_user_id}
curl --include \
--header "Authorization: Basic YXBpLXVzZXJuYW1lOmFwaS1wYXNzd29yZA==" \
--request PUT \
--header "Content-Type: application/json" \
--data-binary " {
\"username\":\"johndoe2\",
\"user_email\":\"johndoe2@awesome.com\",
\"user_phone\":\"518-481-1002\",
\"user_first_name\":\"John\",
\"user_last_name\":\"Doe\",
\"country\":\"US\",
\"password\":\"pass\",
\"account_name\":\"The Awesome Company\"
}" \
'https://rest.clicksend.com/v3/reseller/accounts/{client_user_id}'
Successful response
A message describing the outcome of the operation.
{ "http_code": 200, "response_code": "SUCCESS", "response_msg": "Reseller account has been updated.", "data": { "user_id": 117, "username": "johndoe2", "user_email": "johndoe2@awesome.com", "active": 0, "banned": 0, "balance": "199.997000", "user_phone": "518-481-1002", "reply_to": "originalemail", "delivery_to": null, "user_first_name": "John", "user_last_name": "Doe", "account": 0, "account_name": "The Awesome Company", "account_billing_email": "johndoe2@awesome.com", "account_billing_mobile": "+15184811002", "country": "US", "default_country_sms": "US", "auto_recharge": 0, "auto_recharge_amount": "20.00", "low_credit_amount": "0.00", "setting_unicode_sms": 0, "setting_email_sms_subject": 0, "setting_fix_sender_id": 0, "setting_sms_message_char_limit": 6, "old_dashboard": 0, "balance_commission": "0.299954", "timezone": "Australia/Melbourne", "_currency": { … }, "_subaccount": null } }
Transfer Credit
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
client_user_id | integer(int32) | true | none | User ID of client |
balance | integer(int32) | true | none | Balance to transfer |
currency | string | true | none | Currency of balance to transfer |
Refer to Status Codes for definitions of HTTP status code responses.
https://rest.clicksend.com/v3/reseller/transfer-credit
curl --include \
--header "Authorization: Basic YXBpLXVzZXJuYW1lOmFwaS1wYXNzd29yZA==" \
--request PUT \
--header "Content-Type: application/json" \
--data-binary " {
\"client_user_id\":60,
\"balance\":12,
\"currency\":\"USD\"
}" \
'https://rest.clicksend.com/v3/reseller/transfer-credit'
{ "http_code": 200, "response_code": "SUCCESS", "response_msg": "Your balance has been successfully transferred.", "data": { "user_id": 117, "username": "johndoe2", "user_email": "johndoe2@awesome.com", "active": 0, "banned": 0, "balance": "0.000000", "user_phone": 15184811002, "reply_to": "originalemail", "delivery_to": null, "user_first_name": "John", "user_last_name": "Doe", "account": 0, "account_name": "The Awesome Company", "account_billing_email": "johndoe2@awesome.com", "account_billing_mobile": 15184811002, "country": "US", "default_country_sms": "US", "auto_recharge": 0, "auto_recharge_amount": "20.00", "low_credit_amount": "0.00", "setting_unicode_sms": 0, "setting_email_sms_subject": 0, "setting_fix_sender_id": 0, "setting_sms_message_char_limit": 6, "old_dashboard": 0, "balance_commission": "0.299954", "timezone": "Australia/Melbourne", "_currency": { … }, "_subaccount": { … } } }