v27

latestOpenAPI 3.0.1raw.githubusercontent.com2026-08-0152590.1 KB
Basic

Create a payment link

Create a new payment link in your HubSpot account. This endpoint allows you to specify various attributes for the payment link, such as accepted payment methods, currency, and additional form fields. The payment link can be configured for one-time use and can also collect shipping and billing addresses. This operation requires a valid JSON request body. Some defaults will be applied if no value provided.

post/commerce/payment-links/2026-09-beta/payment-links

Request body

acceptedPaymentMethodsstring[] required

An array of accepted payment methods for the payment link. Valid values include 'CREDIT_OR_DEBIT_CARD', 'ACH', 'SEPA', 'BACS', and 'PADS'.

automatedSalesTaxEnabledboolean

A boolean indicating whether automated sales tax is enabled.

businessUnitIdstring

A string representing the business unit ID associated with the payment link.

collectFullBillingAddressboolean

A boolean indicating whether to collect the full billing address during checkout.

collectShippingAddressboolean

A boolean indicating whether the shipping address should be collected during checkout.

currencyCodestring required

The currency code for the payment, represented as a string.

descriptionHtmlstring

A string containing the HTML description of the payment link.

discountCodeEnabledboolean

A boolean indicating whether discount codes are enabled for the payment link.

discountObjectIdstring

A string representing the object ID of a discount associated with the payment link.

discountObjectIdsstring[] required

An array of strings representing the IDs of discount objects associated with the payment link.

domainIdstring

The domain ID associated with the payment link, represented as a string.

enableDefaultCheckoutFeesboolean required

A boolean indicating whether default checkout fees are enabled.

feeObjectIdsstring[] required

An array of strings representing the IDs of fee objects associated with the payment link.

includeEmailInSuccessRedirectboolean required

A boolean indicating whether to include the email in the success redirect URL.

isOneTimeUseEnabledboolean required

A boolean indicating whether the payment link is enabled for one-time use.

lineItemObjectIdsstring[] required

An array of line item object IDs associated with the payment link, each represented as a string.

paymentLinkNamestring required

The name of the payment link. It is a string value.

state'OFF' | 'ON' required

The state of the payment link, represented as a string. Valid values are 'ON' and 'OFF'.

storePaymentMethodAtCheckoutboolean

A boolean indicating whether to store the payment method at checkout.

successUrlstring

A string that defines the URL to redirect to upon successful payment.

taxObjectIdsstring[] required

An array of string IDs representing tax objects associated with the payment link.

Response

successful operation

acceptedPaymentMethodsstring[] required

An array of accepted payment methods for the payment link. Valid values include 'CREDIT_OR_DEBIT_CARD', 'ACH', 'SEPA', 'BACS', and 'PADS'.

archivedboolean required

A boolean indicating whether the payment link is archived.

archivedAtstring date-time

The date and time when the payment link was archived, in ISO 8601 format.

automatedSalesTaxEnabledboolean required

A boolean indicating whether automated sales tax is enabled for the payment link.

businessUnitIdstring

The business unit ID associated with the payment link, represented as a string.

checkoutFeeIdsstring[] required

An array of checkout fee IDs associated with the payment link.

collectFullBillingAddressboolean required

A boolean indicating whether to collect the full billing address during checkout.

collectShippingAddressboolean required

A boolean indicating whether to collect the shipping address during checkout.

createdAtstring date-time

The date and time when the payment link was created, in ISO 8601 format.

currencyCodestring required

The currency code for the payment link, represented as a string.

descriptionHtmlstring

The HTML description of the payment link, represented as a string.

discountCodeEnabledboolean required

A boolean indicating whether discount codes are enabled for the payment link.

domainIdstring

The domain ID associated with the payment link, represented as a string.

formGuidstring required

The form GUID associated with the payment link, represented as a string.

idstring required

The unique identifier for the payment link, represented as a string.

includeEmailInSuccessRedirectboolean required

A boolean indicating whether to include the email in the success redirect URL.

isOneTimeUseEnabledboolean required

A boolean indicating whether the payment link is enabled for one-time use.

paymentLinkNamestring required

The name of the payment link, represented as a string.

paymentLinkUrlstring required

The URL of the payment link, represented as a string.

state'OFF' | 'ON' required

The current state of the payment link, represented as a string. Valid values include 'ON' and 'OFF'.

storePaymentMethodAtCheckoutboolean required

A boolean indicating whether to store the payment method at checkout.

successUrlstring

The URL to redirect to upon successful payment, represented as a string.

updatedAtstring date-time

The date and time when the payment link was last updated, in ISO 8601 format.