Refresh PayPal Integration Status
POST/api/paypal/integrations/:id/status
Re-reads the account's state from PayPal and returns the updated integration.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
- Connect with PayPal accounts: re-reads the merchant's integration status (payments receivable, primary email confirmed, permissions, transaction-search access). If PayPal can't be reached the stored status is left untouched and
422is returned, so an outage never downgrades a healthy account. - API keys accounts: re-checks that PayPal still accepts the saved Client ID and Secret, which features the app has (transaction search), and that SKU.io's webhook is subscribed on the app.
webhook_warningis a message when the webhook could not be subscribed, otherwise null. Keys PayPal no longer accepts setcredentials_rejected: true.
Errors: 403 without the permission, 404 unknown integration, 409 Connect with PayPal unavailable on this deployment, 422 PayPal unreachable or rejected the request.
Permission: Integrations → Manage (integrations.manage).
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
Unprocessable Entity
Response Headers
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.