Skip to main content
POST
/
v1
/
partners
curl -X POST 'https://api.tolt.com/v1/partners' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
    "first_name": "Michael",
    "last_name": "Scott",
    "email": "michael.scott@dundermifflin.com",
    "program_id": "prg_YRsbPDAKhWfdqJbFACheh",
    "company_name": "Dunder Mifflin",
    "country_code": "US",
    "payout_method": "paypal",
    "payout_details": {
        "email": "michael.paypal@dundermifflin.com"
    }
}'

{
  "success": true,
  "data": [
    {
      "id": "part_yP2D2oFyPsFUfkwzXCzRn3U2",
      "status": "active",
      "first_name": "TEST create",
      "last_name": "test",
      "company_name": null,
      "email": "aaaa@gmail.com",
      "program_id": "prg_ztTmEaAJRtfPVKM9nHhZwhjH",
      "organization_id": "org_qeHXERFhTv5DzxpvxtA5BWL5",
      "group_id": "grp_gMHPxVAQJghkdXSNXyQk6xfB",
      "created_at": "2025-08-06T13:46:07.328Z",
      "updated_at": "2025-08-06T13:46:07.328Z",
      "payout_method": "none",
      "payout_details": {},
      "country_code": null,
      "completed_onboarding": true,
      "rejection_note": null,
      "internal_note": null,
      "suspension_reason": null,
      "first_customer_email_active": true,
      "new_customer_email_active": true,
      "payout_paid_email_active": true
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.tolt.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Base URL https://api.tolt.com


​
Body Parameters

​
first_name*
string
Partner’s first name
​
last_name*
string
Partner’s last name
​
email*
string
Partner’s email address
​
program_id*
string
The program ID that the partner will belong to
​
group_id
string - optional
The group ID to assign the partner to
​
company_name
string - optional
Partner’s company name
​
country_code
string - optional
Two-letter ISO country code of the partner
​
payout_method
string - optional
Partner’s payout method. Valid values are: ‘paypal’, ‘crypto’, ‘wise’, ‘bank_transfer’, ‘wire’, ‘none’
​
payout_details
object - optional
Details specific to the selected payout method (e.g., PayPal email, bank details)
​
notify_partner
boolean - optional
When true, sends a welcome email to the partner after their account is created.

​
Response

​
success
boolean
Whether the request was successful
​
data
array
curl -X POST 'https://api.tolt.com/v1/partners' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
    "first_name": "Michael",
    "last_name": "Scott",
    "email": "michael.scott@dundermifflin.com",
    "program_id": "prg_YRsbPDAKhWfdqJbFACheh",
    "company_name": "Dunder Mifflin",
    "country_code": "US",
    "payout_method": "paypal",
    "payout_details": {
        "email": "michael.paypal@dundermifflin.com"
    }
}'

{
  "success": true,
  "data": [
    {
      "id": "part_yP2D2oFyPsFUfkwzXCzRn3U2",
      "status": "active",
      "first_name": "TEST create",
      "last_name": "test",
      "company_name": null,
      "email": "aaaa@gmail.com",
      "program_id": "prg_ztTmEaAJRtfPVKM9nHhZwhjH",
      "organization_id": "org_qeHXERFhTv5DzxpvxtA5BWL5",
      "group_id": "grp_gMHPxVAQJghkdXSNXyQk6xfB",
      "created_at": "2025-08-06T13:46:07.328Z",
      "updated_at": "2025-08-06T13:46:07.328Z",
      "payout_method": "none",
      "payout_details": {},
      "country_code": null,
      "completed_onboarding": true,
      "rejection_note": null,
      "internal_note": null,
      "suspension_reason": null,
      "first_customer_email_active": true,
      "new_customer_email_active": true,
      "payout_paid_email_active": true
    }
  ]
}