You are here: API Reference > Calls > subscribeWithExistingAccount

subscribeWithExistingAccount

If you have already created an account, use this call to create a subscription for that account. The call takes an account ID, creates a new subscription, and, optionally, generates an invoice on that account and applies a payment right away.

Note

If you use this call on an account with an existing subscription, the new subscription will be created and, if options are set to generate an invoice and apply payment, the invoice will include outstanding charges for all existing subscriptions for that account (including the previous subscriptions as well as the new one being created). The payment would then be applied to the outstanding balance for the newly created invoice.

Syntax and Argument

subscribeWithExistingAccount(SubscribeWithExistingAccountRequest[])

The argument is as shown in the following table. For information on the field types, see Field Types.

Argument	Description
SubscribeWithExistingAccountRequest[]	An array of one or more objects of type zObject.

Using this Call

There are two common scenarios for which you may wish to use this call.

The most common usage is this: One of your customers has created an account for a free trial and now wants to activate that subscription. Use this call to do so and to provide payment information and apply a payment.
Less commonly, you may wish to create a second subscription for an existing account.

SubscribeWithExistingAccountRequest

SubscribeOptions

SubscriptionData

Open topic with navigation