Disconnect PayPal Integration
POST/api/paypal/integrations/:id/disconnect
Disconnects the PayPal account from SKU.io: clears the merchant connection, cancels the account's active pay links (checkout would refuse them once the account is gone) and stops routing its webhooks. Links whose payment is already processing are kept so the payment can still complete.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
The integration itself is kept (with its payments, refunds and transactions) and can be connected again later. An account that never took a payment can instead be removed with Delete PayPal Integration.
Permission: Integrations → Manage (integrations.manage); otherwise 403.
Authentication: Bearer token (Personal Access Token).
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Not Found
Response Headers
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.