Set your payout details

curl -X PUT https://api.subscriby.net/v1/me/partner/payout-details \  -H "Authorization: Bearer $SUBSCRIBY_TOKEN" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "method": "paypal",    "details": "ada@example.com",    "legal_name": "Ada Lovelace",    "tax_country": "GB",    "us_person": false,    "accept_terms": true  }'

Writes how you are paid: the rail, what it pays to, and the tax declaration every cash rail needs. paypal and crypto take their one details (the PayPal email, the USDT TRC20 wallet address); wise and remitly take the bank account (bank_holder, bank_name, bank_country, bank_account_number, and bank_swift, bank_branch_code, bank_address when the transfer needs them); credit takes nothing and is accepted while that rail is open. Only the destination the chosen rail uses is kept, encrypted; a rail you leave behind keeps nothing on file. The response is the partner object with payout_method and payout_details_complete updated and the destination absent.

The terms come first. A rail cannot be saved until you have accepted the Partner Program Terms: send accept_terms: true here, or call the terms endpoint before.

Requires ability

account:write

The token must hold this ability, or the call is refused with 403.

MCP tool

update_partner_payout_details

Runs the same action from an agent, behind the same ability.

Idempotent

Idempotency-Key

Send the header on every call; the same key replays the original response for 24 hours.

Authorization

bearerToken

AuthorizationBearer <token>

A personal access token minted on the dashboard under Settings, then Tokens, sent as Authorization: Bearer sbt_live_…. The token carries the abilities each endpoint lists under Requires ability and is frozen to one team.

In: header

Header Parameters

Idempotency-Key*string

A key unique to this operation, such as a fresh UUID. The same key replays the original 2xx response for 24 hours (with Idempotent-Replay: true), so a retry after a timeout never repeats the write; the same key with a different body is refused with 409.

Formatuuid

Request body

JSONWhat the request carriesRequiredapplication/json

The rail to be paid by, what it pays to, and the tax declaration. Only the destination the chosen rail uses is kept; a rail left behind keeps nothing on file.

method*PartnerPayoutMethod

The rail: credit (Subscriby Credit applied to your own invoices, while the rail is open), paypal, wise, remitly or crypto (USDT on TRC20).

Value in

"credit"
"paypal"
"wise"
"remitly"
"crypto"

details?|

What a single-detail rail pays to: the PayPal email for paypal, the wallet address for crypto. Required on those rails, ignored on the others. At most 190 characters.

Lengthlength <= 190

bank_holder?|

The name on the bank account, for wise and remitly. At most 120 characters.

Lengthlength <= 120

bank_name?|

The bank, for wise and remitly. At most 120 characters.

Lengthlength <= 120

bank_country?|

Where the bank is, as an ISO 3166-1 alpha-2 code, for wise and remitly.

Length2 <= length <= 2

bank_account_number?|

The account number or IBAN, for wise and remitly: letters, digits, spaces and dashes, at most 40 characters.

Match^[A-Za-z0-9 -]+$

Lengthlength <= 40

bank_swift?|

The SWIFT or BIC code, when the bank has one: 8 or 11 characters.

Match^[A-Za-z]{6}[A-Za-z0-9]{2}([A-Za-z0-9]{3})?$

bank_branch_code?|

The branch, routing, sort or IFSC code, when the transfer needs one: letters, digits, spaces and dashes, at most 20 characters.

Match^[A-Za-z0-9 -]+$

Lengthlength <= 20

bank_address?|

The account holder's address, when the transfer needs one. At most 200 characters.

Lengthlength <= 200

legal_name?|

The name a payment is made out to. Required on every cash rail. At most 120 characters.

Lengthlength <= 120

tax_country?|

The country of tax residence, as an ISO 3166-1 alpha-2 code. Required on every cash rail.

Length2 <= length <= 2

us_person?|

Whether you are a US person for tax purposes.

accept_terms?boolean

Send true to accept the Partner Program Terms with this save. A rail cannot be saved until the terms are accepted, here or through the terms endpoint.

Responses

200OKapplication/json

The partner object after the change.

data*

The response's payload.

400Bad requestIDEMPOTENCY_KEY_MISSINGapplication/json

Every write needs an Idempotency-Key header. Send a fresh UUID per distinct operation.

error*