---
title: "Update a repeating invoice's customer email"
method: PATCH
path: "/v1/invoices/recurring/{id}"
tags: ["Invoices"]
---

# Update a repeating invoice's customer email

`PATCH /v1/invoices/recurring/{id}`

## Request

- Base URL: `https://invoices-api.paymongo.com`
- URL: `https://invoices-api.paymongo.com/v1/invoices/recurring/{id}`
- Auth: HTTP basic

Changes the email future cycles bill to. The only patchable field - cadence, amount, and schedule are frozen at registration. A foreign or cross-mode id reads as 404.

## Path parameters

- `id` string, required

## Request body

- UpdateRecurringEmailRequestDTO
  - `customer_email` string, required

## Response `200`

OK

- object: Standard response containing data and its metadata if any
  - `data` RecurringResponseDTO
    - `agreement_id` string
    - `amount` integer
    - `anchor_at` string: AnchorAt is the first-cycle instant for a merchant (send-mode) registration; null for a delegated one.
    - `cadence` string
    - `created_at` string
    - `currency` string
    - `customer_email` string
    - `customer_id` string
    - `customer_name` string
    - `cycle_count` integer
    - `cycles_generated` integer
    - `delivery_mode` string: DeliveryMode is delegated | send | charge; charge is executed off-session by this service. Merchant registrations are always send.
    - `description` string
    - `id` string
    - `interval_count` integer
    - `live_mode` boolean
    - `next_run_at` string: NextRunAt is the next cycle's instant (null unless active): the anchor before the first cycle, else the cadence's next due instant past the last generated cycle.
    - `organization_id` string
    - `payment_method_ref` string
    - `payment_methods` string[]: PaymentMethods is frozen at registration and stamped onto every cycle invoice.
    - `status` string
    - `subscription_id` string
    - `trigger_id` string
    - `updated_at` string
    - `workflow_id` string
  - `has_more` boolean
  - `page` integer
  - `page_count` integer
  - `per_page` integer
  - `total` integer

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/paymongo/apis/invoices.md) - [All operations](https://skmtc.dev/paymongo/apis/invoices/llms.txt) - [OpenAPI document](https://skmtc.dev/paymongo/apis/invoices/revisions/95484a918a20?raw)