---
title: "Add PayPal payment details"
method: POST
path: "/connectors/paypal/v1/payment_details/tokens"
---

# Add PayPal payment details

`POST /connectors/paypal/v1/payment_details/tokens`

## Request

- Base URL: `https://mediastoreapi-sandbox.cleeng.com`
- URL: `https://mediastoreapi-sandbox.cleeng.com/connectors/paypal/v1/payment_details/tokens`
- Auth: API key in header `Authorization`

Use this method to add PayPal payment details, so that new payment details can be used for recurring payments. 

Example use cases include: a customer changes payment method from a card to PayPal, or wants to use a different account in PayPal. For more information, see the [docs](https://developers.cleeng.com/docs/payment-information#customer-payment-details).

## Request body

- object
  - `paymentMethodId` integer, required: Publisher PayPal payment method ID
  - `successUrl` string, required: URL to redirect the customer to after successful adding payment details
  - `cancelUrl` string, required: URL to redirect the customer to after canceled adding payment details
  - `errorUrl` string, required: URL to redirect the customer to after an error occurs.

## Response `200`

200

- object
  - `responseData` object
    - `redirectUrl` string
  - `errors` unknown[]
    - unknown

## Other responses

- `400`: 400
- `401`: 401
- `404`: 404

## Changes

- **2026-11-03** `b4b65aa4f14c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cleeng/apis/mediastore-api/changes/connectors/paypal/v1/payment_details/tokens/post.md)

---

[API](https://skmtc.dev/cleeng/apis/mediastore-api.md) - [All operations](https://skmtc.dev/cleeng/apis/mediastore-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cleeng/apis/mediastore-api/revisions/b4b65aa4f14c?raw)