curl --request PUT \
  --url https://api-m.sandbox.paypal.com/v1/commerce/billing/plans/{plan_code} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "code": "<string>",
  "billing_cycle": "MONTHLY",
  "description": "<string>",
  "trial_period": 123,
  "pay_in_advance": true,
  "tax_codes": [
    "standard_vat"
  ],
  "cascading_updates": true,
  "usage_based_charges": [
    {
      "id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "metric_id": "<string>",
      "charge_model": "GRADUATED",
      "tax_codes": [
        "standard_vat"
      ],
      "properties": {}
    }
  ]
}
'

{
  "status": "200 OK",
  "headers": {
    "Content-Type": "application/json"
  },
  "body": {
    "name": "UBB Plan - Pro",
    "code": "ubb_plan_1753837176",
    "billing_cycle": "WEEKLY",
    "description": "Pro plan for pro UBB customers",
    "amount": {
      "value": 170,
      "currency_code": "USD"
    },
    "trial_period": 0,
    "pay_in_advance": true,
    "cascading_updates": true,
    "usage_based_charges": [
      {
        "id": "fggdgd5c-31a6-4d74-b607-ac3915796ab9",
        "metric_id": "92c9175c-31a6-4d74-b607-ac3915796ab9",
        "charge_model": "STANDARD",
        "properties": {
          "amount": "1.00"
        },
        "min_amount": {
          "value": 1,
          "currency_code": "USD"
        }
      }
    ],
    "minimum_commitment": {
      "amount": {
        "value": 100,
        "currency_code": "USD"
      },
      "invoice_display_name": "Minimum Commitment",
      "id": "cc82edfd-8198-4942-bed8-fcd7afb5191e",
      "plan_code": "ubb_plan_1753826420",
      "created_at": "2025-07-31T08:41:19Z",
      "updated_at": "2025-07-31T08:41:19Z"
    },
    "created_at": "2025-07-30T00:59:35Z",
    "updated_at": "2025-07-31T08:41:19Z",
    "id": "95de3538-3827-496b-89a0-120745360830"
  }
}

{
  "name": "INVALID_REQUEST",
  "message": "Request is not well-formed, syntactically incorrect, or violates schema.",
  "debug_id": "dc99e3955cdd8",
  "details": [
    {
      "field": "/email",
      "value": "abc",
      "location": "body",
      "issue": "INVALID_PARAMETER_VALUE",
      "description": "The value of a field does not conform to the expected format."
    }
  ]
}

{
  "name": "NOT_AUTHORIZED",
  "message": "Authorization failed due to insufficient permissions.",
  "debug_id": "565f78f101498",
  "details": [
    {
      "issue": "PERMISSION_DENIED",
      "description": "You do not have permission to access or perform operations on this resource."
    }
  ]
}

{
  "name": "<string>",
  "debug_id": "<string>",
  "message": "<string>",
  "details": [
    {
      "field": "<string>",
      "value": "<string>",
      "location": "<string>",
      "issue": "<string>",
      "description": "<string>"
    }
  ]
}

{
  "name": "UNPROCESSABLE_ENTITY",
  "message": "The requested action could not be performed, semantically incorrect, or failed business validation.",
  "debug_id": "90957fca61718",
  "details": [
    {
      "field": "/email",
      "value": "sdfwdj@sdfs.com",
      "location": "body",
      "issue": "UNSUPPORTED_EMAIL",
      "description": "The email provided is not supported."
    }
  ]
}

{
  "name": "INTERNAL_SERVER_ERROR",
  "message": "An internal server error has occurred.",
  "debug_id": "90957fca61718"
}