---
title: "POST /v23/customers/{+customerId}/billingSetups:mutate"
method: POST
path: "/v23/customers/{+customerId}/billingSetups:mutate"
tags: ["customers"]
---

# POST /v23/customers/{+customerId}/billingSetups:mutate

`POST /v23/customers/{+customerId}/billingSetups:mutate`

Creates a billing setup, or cancels an existing billing setup. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [BillingSetupError]() [DateError]() [FieldError]() [HeaderError]() [InternalError]() [MutateError]() [QuotaError]() [RequestError]()

## Path parameters

- `customerId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesMutateBillingSetupRequest — Request message for billing setup mutate operations.
  - `operation` GoogleAdsSearchads360V23ServicesBillingSetupOperation — A single operation on a billing setup, which describes the cancellation of an existing billing setup.
    - `create` GoogleAdsSearchads360V23ResourcesBillingSetup — A billing setup, which associates a payments account and an advertiser. A billing setup is specific to one advertiser.
      - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'PENDING' | 'APPROVED_HELD' | 'APPROVED' | 'CANCELLED' — Output only. The status of the billing setup.
      - `startDateTime` string — Immutable. The start date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. Only a future time is allowed.
      - `paymentsAccount` string — Immutable. The resource name of the payments account associated with this billing setup. Payments resource names have the form: `customers/{customer_id}/paymentsAccounts/{payments_account_id}` When setting up billing, this is used to signup with an existing payments account (and then payments_account_info should not be set). When getting a billing setup, this and payments_account_info will be populated.
      - `startTimeType` 'UNSPECIFIED' | 'UNKNOWN' | 'NOW' | 'FOREVER' — Immutable. The start time as a type. Only NOW is allowed.
      - `endDateTime` string — Output only. The end date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format.
      - `resourceName` string — Immutable. The resource name of the billing setup. BillingSetup resource names have the form: `customers/{customer_id}/billingSetups/{billing_setup_id}`
      - `id` string, int64 — Output only. The ID of the billing setup.
      - `paymentsAccountInfo` GoogleAdsSearchads360V23ResourcesBillingSetupPaymentsAccountInfo — Container of payments account information for this billing.
        - `paymentsProfileId` string — Immutable. A 12 digit id used to identify the payments profile associated with the billing setup. This must be passed in as a string with dashes, for example, "1234-5678-9012".
        - `paymentsAccountName` string — Immutable. The name of the payments account associated with the billing setup. This enables the user to specify a meaningful name for a payments account to aid in reconciling monthly invoices. This name will be printed in the monthly invoices.
        - `paymentsProfileName` string — Output only. The name of the payments profile associated with the billing setup.
        - `paymentsAccountId` string — Output only. A 16 digit id used to identify the payments account associated with the billing setup. This must be passed as a string with dashes, for example, "1234-5678-9012-3456".
        - `secondaryPaymentsProfileId` string — Output only. A secondary payments profile id present in uncommon situations, for example, when a sequential liability agreement has been arranged.
      - `endTimeType` 'UNSPECIFIED' | 'UNKNOWN' | 'NOW' | 'FOREVER' — Output only. The end time as a type. The only possible value is FOREVER.
    - `remove` string — Resource name of the billing setup to remove. A setup cannot be removed unless it is in a pending state or its scheduled start time is in the future. The resource name looks like `customers/{customer_id}/billingSetups/{billing_id}`.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/searchads360.md) · [All operations](https://skmtc.net/google/apis/searchads360/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/searchads360/revisions/40d087435afd/schema)