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
}
]
}
{
"success": false,
"error": "Partner with this email already exists.",
"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",
"status": "active",
"created_at": "2025-01-13T10:06:11.251Z",
"updated_at": "2025-01-13T10:06:11.251Z"
}
}
Partners
Create Partner
This endpoint creates a partner.
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
}
]
}
{
"success": false,
"error": "Partner with this email already exists.",
"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",
"status": "active",
"created_at": "2025-01-13T10:06:11.251Z",
"updated_at": "2025-01-13T10:06:11.251Z"
}
}
Base URL https://api.tolt.com
Body Parameters
string
Partner’s first name
string
Partner’s last name
string
Partner’s email address
string
The program ID that the partner will belong to
string - optional
The group ID to assign the partner to
string - optional
Partner’s company name
string - optional
Two-letter ISO country code of the partner
string - optional
Partner’s payout method. Valid values are: ‘paypal’, ‘crypto’, ‘wise’,
‘bank_transfer’, ‘wire’, ‘none’
object - optional
Details specific to the selected payout method (e.g., PayPal email, bank
details)
boolean - optional
When true, sends a welcome email to the partner after their account is
created.
Response
boolean
Whether the request was successful
array
Hide properties
Hide properties
string
Unique identifier for the partner,
uuid or prefixed with part_string
Partner’s first name
string
Partner’s last name
string
Partner’s email address
string
Partner’s company name
string
Program ID the partner belongs to
string
Organization ID
string
Group ID the partner belongs to
string
Partner’s payout method
object
Payout method specific details
string
Two-letter ISO country code
string
ISO 8601 timestamp of creation
string
ISO 8601 timestamp of last update
boolean
The partner has completed onboarding.
string | null
A note why a partner was rejected.
string | null
A note related to the partner.
string | null
Reason for partner suspension if applicable.
boolean
Whether first customer email notifications are active for this partner.
boolean
Whether new customer email notifications are active for this partner.
boolean
Whether payout paid email notifications are active for this partner.
Errors
object
Returned when a partner with the same email already exists in the program. The
response includes the existing partner under
data, so you can connect it to
your system without a separate lookup.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
}
]
}
{
"success": false,
"error": "Partner with this email already exists.",
"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",
"status": "active",
"created_at": "2025-01-13T10:06:11.251Z",
"updated_at": "2025-01-13T10:06:11.251Z"
}
}
⌘I