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_s7mbzRGn46BhVgNFHD6fDgXW",
    "first_name": "Michael",
    "last_name": "Scott",
    "email": "michael.scott@dundermifflin.com",
    "company_name": "Dunder Mifflin",
    "program_id": "prg_YRsbPDAKhWfdqJbFACheh",
    "organization_id": "org_JE3mfYNL9ci7sFaJazAv2",
    "group_id": "grp_Zc2uw9zm1eyBiD3MHcjV3RDn",
    "payout_method": "paypal",
    "payout_details": {
      "email": "michael.paypal@dundermifflin.com"
    },
    "country_code": "US",
    "created_at": "2025-01-13T10:06:11.251Z",
    "status": "active",
    "completed_onboarding": true,
    "rejection_note": null,
    "internal_note": null
  }
}

​
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)

​
Response

​
success
boolean

Whether the request was successful

​
data
object
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_s7mbzRGn46BhVgNFHD6fDgXW",
    "first_name": "Michael",
    "last_name": "Scott",
    "email": "michael.scott@dundermifflin.com",
    "company_name": "Dunder Mifflin",
    "program_id": "prg_YRsbPDAKhWfdqJbFACheh",
    "organization_id": "org_JE3mfYNL9ci7sFaJazAv2",
    "group_id": "grp_Zc2uw9zm1eyBiD3MHcjV3RDn",
    "payout_method": "paypal",
    "payout_details": {
      "email": "michael.paypal@dundermifflin.com"
    },
    "country_code": "US",
    "created_at": "2025-01-13T10:06:11.251Z",
    "status": "active",
    "completed_onboarding": true,
    "rejection_note": null,
    "internal_note": null
  }
}