UpPromote Public API
  1. Affiliate
UpPromote Public API
  • API overview
  • Affiliate
    • Get affiliates
      GET
    • Get affiliate by ID
      GET
    • Create an affiliate
      POST
    • Approve/Deny affiliate
      POST
    • Set upline for an affiliate
      POST
    • Move an affiliate to a program
      POST
    • Connect a customer to an affiliate
      POST
  • Coupon
    • Get coupons
      GET
    • Assign a coupon to an affiliate
      POST
  • Payment
    • Get unpaid payments
      GET
    • Get paid payments (History)
      GET
    • Count total paid payments
      GET
    • Get a payment by ID
      GET
    • Mark as paid a manual payment
      POST
  • Referral
    • Get list referrals
      GET
    • Get a referral by ID
      GET
    • Create a referral
      POST
    • Add referral adjustment
      POST
  • Webhook
    • Get webhook subscriptions
      GET
    • Subscribe a webhook event
      POST
    • Update a webhook subscription
      PUT
    • Delete a webhook subscription
      DELETE
  • Webhook Event Payload
    • Webhook overview
    • Referral new
      POST
    • Referral approved
      POST
    • Referral denied
      POST
    • Referral status changed
      POST
    • Affiliate new
      POST
    • Affiliate approved
      POST
    • Affiliate inactive
      POST
    • Affiliate status changed
      POST
    • Payment paid
      POST
  1. Affiliate

Create an affiliate

POST
/api/v2/affiliates
The status field accepts the values active and inactive.
The send_emailfield accepts the values boolen true and fasle.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

🔴500Server Error
🟠401Unauthorized
🟠422Parameter Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://aff-api.uppromote.com/api/v2/affiliates' \
--header 'Accept: application/json' \
--header 'Authorization: ****************************' \
--header 'Content-Type: application/json' \
--data-raw '{
  "email": "example@gmail.com",
  "first_name": "q",
  "last_name": "10",
  "password": "123123",
  "program_id": 152,
  "status": "active",
  "send_email": true,
  "company": "Test Company",
  "address": "No 1, Example Street",
  "country": "Vietnam",
  "city": "Ho Chi Minh",
  "state": "District 1",
  "phone": "0123456789",
  "facebook": "facebook.com/example",
  "youtube": "youtube.com/@example",
  "instagram": "instagram.com/example",
  "twitter": "twitter.com/example"
}'
Response Response Example
200 - Example
{
    "status": 200,
    "message": "success",
    "data": {
        "affiliate_id": 2029462,
        "affiliate_email": "test_api@gmail.com"
    }
}
Modified at 2025-10-06 04:39:50
Previous
Get affiliate by ID
Next
Approve/Deny affiliate
Built with