Create contract

curl --request POST \
  --url https://api.hubapi.com/commerce/contracts/2026-09-beta/contracts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "automatedTaxesEnabled": {},
  "billingAddress": {},
  "billingCompanyId": {},
  "billingContactId": "<string>",
  "billingStartDateOverride": {},
  "contractEffectiveDate": "2023-12-25",
  "currencyCode": "<string>",
  "dealId": {},
  "externalPaymentMethodReferenceId": {},
  "hubspotBillingEnabled": true,
  "lineItems": [
    {
      "mode": "CUSTOM",
      "name": "<string>",
      "pricing": {
        "prices": [
          {
            "currencyCode": "<string>",
            "price": {},
            "maxQuantity": "<string>"
          }
        ]
      },
      "quantity": 123,
      "allowBuyerSelectedQuantity": true,
      "billingCycleAnchorDate": "2023-12-25",
      "billingStartDelayDays": 123,
      "billingStartDelayMonths": 123,
      "buyerSelectedQuantityMax": 123,
      "buyerSelectedQuantityMin": 123,
      "description": "<string>",
      "discount": 123,
      "discountPercentage": 123,
      "externalId": "<string>",
      "images": "<string>",
      "isEditablePrice": true,
      "isOptional": true,
      "lineItemCurrencyCode": "<string>",
      "positionOnQuote": 123,
      "priceBookId": "<string>",
      "productId": "<string>",
      "productType": "<string>",
      "recurringBillingEndDate": "2023-12-25",
      "recurringBillingPeriod": "<string>",
      "recurringBillingStartDate": "2023-12-25",
      "richTextDescription": "<string>",
      "sku": "<string>",
      "variantId": "<string>"
    }
  ],
  "locale": {},
  "name": "<string>",
  "netPaymentTerms": {},
  "ownerId": {},
  "paymentEnabled": true,
  "poNumber": {},
  "sellerCompanyAddress": {},
  "sellerCompanyDomain": {},
  "sellerCompanyName": {},
  "sellerEmail": {},
  "sellerFirstName": {},
  "sellerLastName": {},
  "sellerPhone": {},
  "addressTypesToCollect": [],
  "allowedPaymentMethods": [],
  "customProperties": {}
}
'

import requests

url = "https://api.hubapi.com/commerce/contracts/2026-09-beta/contracts"

payload = {
    "automatedTaxesEnabled": {},
    "billingAddress": {},
    "billingCompanyId": {},
    "billingContactId": "<string>",
    "billingStartDateOverride": {},
    "contractEffectiveDate": "2023-12-25",
    "currencyCode": "<string>",
    "dealId": {},
    "externalPaymentMethodReferenceId": {},
    "hubspotBillingEnabled": True,
    "lineItems": [
        {
            "mode": "CUSTOM",
            "name": "<string>",
            "pricing": { "prices": [
                    {
                        "currencyCode": "<string>",
                        "price": {},
                        "maxQuantity": "<string>"
                    }
                ] },
            "quantity": 123,
            "allowBuyerSelectedQuantity": True,
            "billingCycleAnchorDate": "2023-12-25",
            "billingStartDelayDays": 123,
            "billingStartDelayMonths": 123,
            "buyerSelectedQuantityMax": 123,
            "buyerSelectedQuantityMin": 123,
            "description": "<string>",
            "discount": 123,
            "discountPercentage": 123,
            "externalId": "<string>",
            "images": "<string>",
            "isEditablePrice": True,
            "isOptional": True,
            "lineItemCurrencyCode": "<string>",
            "positionOnQuote": 123,
            "priceBookId": "<string>",
            "productId": "<string>",
            "productType": "<string>",
            "recurringBillingEndDate": "2023-12-25",
            "recurringBillingPeriod": "<string>",
            "recurringBillingStartDate": "2023-12-25",
            "richTextDescription": "<string>",
            "sku": "<string>",
            "variantId": "<string>"
        }
    ],
    "locale": {},
    "name": "<string>",
    "netPaymentTerms": {},
    "ownerId": {},
    "paymentEnabled": True,
    "poNumber": {},
    "sellerCompanyAddress": {},
    "sellerCompanyDomain": {},
    "sellerCompanyName": {},
    "sellerEmail": {},
    "sellerFirstName": {},
    "sellerLastName": {},
    "sellerPhone": {},
    "addressTypesToCollect": [],
    "allowedPaymentMethods": [],
    "customProperties": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    automatedTaxesEnabled: {},
    billingAddress: {},
    billingCompanyId: {},
    billingContactId: '<string>',
    billingStartDateOverride: {},
    contractEffectiveDate: '2023-12-25',
    currencyCode: '<string>',
    dealId: {},
    externalPaymentMethodReferenceId: {},
    hubspotBillingEnabled: true,
    lineItems: [
      {
        mode: 'CUSTOM',
        name: '<string>',
        pricing: {prices: [{currencyCode: '<string>', price: {}, maxQuantity: '<string>'}]},
        quantity: 123,
        allowBuyerSelectedQuantity: true,
        billingCycleAnchorDate: '2023-12-25',
        billingStartDelayDays: 123,
        billingStartDelayMonths: 123,
        buyerSelectedQuantityMax: 123,
        buyerSelectedQuantityMin: 123,
        description: '<string>',
        discount: 123,
        discountPercentage: 123,
        externalId: '<string>',
        images: '<string>',
        isEditablePrice: true,
        isOptional: true,
        lineItemCurrencyCode: '<string>',
        positionOnQuote: 123,
        priceBookId: '<string>',
        productId: '<string>',
        productType: '<string>',
        recurringBillingEndDate: '2023-12-25',
        recurringBillingPeriod: '<string>',
        recurringBillingStartDate: '2023-12-25',
        richTextDescription: '<string>',
        sku: '<string>',
        variantId: '<string>'
      }
    ],
    locale: {},
    name: '<string>',
    netPaymentTerms: {},
    ownerId: {},
    paymentEnabled: true,
    poNumber: {},
    sellerCompanyAddress: {},
    sellerCompanyDomain: {},
    sellerCompanyName: {},
    sellerEmail: {},
    sellerFirstName: {},
    sellerLastName: {},
    sellerPhone: {},
    addressTypesToCollect: [],
    allowedPaymentMethods: [],
    customProperties: {}
  })
};

fetch('https://api.hubapi.com/commerce/contracts/2026-09-beta/contracts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hubapi.com/commerce/contracts/2026-09-beta/contracts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'automatedTaxesEnabled' => [
        
    ],
    'billingAddress' => [
        
    ],
    'billingCompanyId' => [
        
    ],
    'billingContactId' => '<string>',
    'billingStartDateOverride' => [
        
    ],
    'contractEffectiveDate' => '2023-12-25',
    'currencyCode' => '<string>',
    'dealId' => [
        
    ],
    'externalPaymentMethodReferenceId' => [
        
    ],
    'hubspotBillingEnabled' => true,
    'lineItems' => [
        [
                'mode' => 'CUSTOM',
                'name' => '<string>',
                'pricing' => [
                                'prices' => [
                                                                [
                                                                                                                                'currencyCode' => '<string>',
                                                                                                                                'price' => [
                                                                                                                                                                                                                                                                
                                                                                                                                ],
                                                                                                                                'maxQuantity' => '<string>'
                                                                ]
                                ]
                ],
                'quantity' => 123,
                'allowBuyerSelectedQuantity' => true,
                'billingCycleAnchorDate' => '2023-12-25',
                'billingStartDelayDays' => 123,
                'billingStartDelayMonths' => 123,
                'buyerSelectedQuantityMax' => 123,
                'buyerSelectedQuantityMin' => 123,
                'description' => '<string>',
                'discount' => 123,
                'discountPercentage' => 123,
                'externalId' => '<string>',
                'images' => '<string>',
                'isEditablePrice' => true,
                'isOptional' => true,
                'lineItemCurrencyCode' => '<string>',
                'positionOnQuote' => 123,
                'priceBookId' => '<string>',
                'productId' => '<string>',
                'productType' => '<string>',
                'recurringBillingEndDate' => '2023-12-25',
                'recurringBillingPeriod' => '<string>',
                'recurringBillingStartDate' => '2023-12-25',
                'richTextDescription' => '<string>',
                'sku' => '<string>',
                'variantId' => '<string>'
        ]
    ],
    'locale' => [
        
    ],
    'name' => '<string>',
    'netPaymentTerms' => [
        
    ],
    'ownerId' => [
        
    ],
    'paymentEnabled' => true,
    'poNumber' => [
        
    ],
    'sellerCompanyAddress' => [
        
    ],
    'sellerCompanyDomain' => [
        
    ],
    'sellerCompanyName' => [
        
    ],
    'sellerEmail' => [
        
    ],
    'sellerFirstName' => [
        
    ],
    'sellerLastName' => [
        
    ],
    'sellerPhone' => [
        
    ],
    'addressTypesToCollect' => [
        
    ],
    'allowedPaymentMethods' => [
        
    ],
    'customProperties' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hubapi.com/commerce/contracts/2026-09-beta/contracts"

	payload := strings.NewReader("{\n  \"automatedTaxesEnabled\": {},\n  \"billingAddress\": {},\n  \"billingCompanyId\": {},\n  \"billingContactId\": \"<string>\",\n  \"billingStartDateOverride\": {},\n  \"contractEffectiveDate\": \"2023-12-25\",\n  \"currencyCode\": \"<string>\",\n  \"dealId\": {},\n  \"externalPaymentMethodReferenceId\": {},\n  \"hubspotBillingEnabled\": true,\n  \"lineItems\": [\n    {\n      \"mode\": \"CUSTOM\",\n      \"name\": \"<string>\",\n      \"pricing\": {\n        \"prices\": [\n          {\n            \"currencyCode\": \"<string>\",\n            \"price\": {},\n            \"maxQuantity\": \"<string>\"\n          }\n        ]\n      },\n      \"quantity\": 123,\n      \"allowBuyerSelectedQuantity\": true,\n      \"billingCycleAnchorDate\": \"2023-12-25\",\n      \"billingStartDelayDays\": 123,\n      \"billingStartDelayMonths\": 123,\n      \"buyerSelectedQuantityMax\": 123,\n      \"buyerSelectedQuantityMin\": 123,\n      \"description\": \"<string>\",\n      \"discount\": 123,\n      \"discountPercentage\": 123,\n      \"externalId\": \"<string>\",\n      \"images\": \"<string>\",\n      \"isEditablePrice\": true,\n      \"isOptional\": true,\n      \"lineItemCurrencyCode\": \"<string>\",\n      \"positionOnQuote\": 123,\n      \"priceBookId\": \"<string>\",\n      \"productId\": \"<string>\",\n      \"productType\": \"<string>\",\n      \"recurringBillingEndDate\": \"2023-12-25\",\n      \"recurringBillingPeriod\": \"<string>\",\n      \"recurringBillingStartDate\": \"2023-12-25\",\n      \"richTextDescription\": \"<string>\",\n      \"sku\": \"<string>\",\n      \"variantId\": \"<string>\"\n    }\n  ],\n  \"locale\": {},\n  \"name\": \"<string>\",\n  \"netPaymentTerms\": {},\n  \"ownerId\": {},\n  \"paymentEnabled\": true,\n  \"poNumber\": {},\n  \"sellerCompanyAddress\": {},\n  \"sellerCompanyDomain\": {},\n  \"sellerCompanyName\": {},\n  \"sellerEmail\": {},\n  \"sellerFirstName\": {},\n  \"sellerLastName\": {},\n  \"sellerPhone\": {},\n  \"addressTypesToCollect\": [],\n  \"allowedPaymentMethods\": [],\n  \"customProperties\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hubapi.com/commerce/contracts/2026-09-beta/contracts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"automatedTaxesEnabled\": {},\n  \"billingAddress\": {},\n  \"billingCompanyId\": {},\n  \"billingContactId\": \"<string>\",\n  \"billingStartDateOverride\": {},\n  \"contractEffectiveDate\": \"2023-12-25\",\n  \"currencyCode\": \"<string>\",\n  \"dealId\": {},\n  \"externalPaymentMethodReferenceId\": {},\n  \"hubspotBillingEnabled\": true,\n  \"lineItems\": [\n    {\n      \"mode\": \"CUSTOM\",\n      \"name\": \"<string>\",\n      \"pricing\": {\n        \"prices\": [\n          {\n            \"currencyCode\": \"<string>\",\n            \"price\": {},\n            \"maxQuantity\": \"<string>\"\n          }\n        ]\n      },\n      \"quantity\": 123,\n      \"allowBuyerSelectedQuantity\": true,\n      \"billingCycleAnchorDate\": \"2023-12-25\",\n      \"billingStartDelayDays\": 123,\n      \"billingStartDelayMonths\": 123,\n      \"buyerSelectedQuantityMax\": 123,\n      \"buyerSelectedQuantityMin\": 123,\n      \"description\": \"<string>\",\n      \"discount\": 123,\n      \"discountPercentage\": 123,\n      \"externalId\": \"<string>\",\n      \"images\": \"<string>\",\n      \"isEditablePrice\": true,\n      \"isOptional\": true,\n      \"lineItemCurrencyCode\": \"<string>\",\n      \"positionOnQuote\": 123,\n      \"priceBookId\": \"<string>\",\n      \"productId\": \"<string>\",\n      \"productType\": \"<string>\",\n      \"recurringBillingEndDate\": \"2023-12-25\",\n      \"recurringBillingPeriod\": \"<string>\",\n      \"recurringBillingStartDate\": \"2023-12-25\",\n      \"richTextDescription\": \"<string>\",\n      \"sku\": \"<string>\",\n      \"variantId\": \"<string>\"\n    }\n  ],\n  \"locale\": {},\n  \"name\": \"<string>\",\n  \"netPaymentTerms\": {},\n  \"ownerId\": {},\n  \"paymentEnabled\": true,\n  \"poNumber\": {},\n  \"sellerCompanyAddress\": {},\n  \"sellerCompanyDomain\": {},\n  \"sellerCompanyName\": {},\n  \"sellerEmail\": {},\n  \"sellerFirstName\": {},\n  \"sellerLastName\": {},\n  \"sellerPhone\": {},\n  \"addressTypesToCollect\": [],\n  \"allowedPaymentMethods\": [],\n  \"customProperties\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/commerce/contracts/2026-09-beta/contracts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"automatedTaxesEnabled\": {},\n  \"billingAddress\": {},\n  \"billingCompanyId\": {},\n  \"billingContactId\": \"<string>\",\n  \"billingStartDateOverride\": {},\n  \"contractEffectiveDate\": \"2023-12-25\",\n  \"currencyCode\": \"<string>\",\n  \"dealId\": {},\n  \"externalPaymentMethodReferenceId\": {},\n  \"hubspotBillingEnabled\": true,\n  \"lineItems\": [\n    {\n      \"mode\": \"CUSTOM\",\n      \"name\": \"<string>\",\n      \"pricing\": {\n        \"prices\": [\n          {\n            \"currencyCode\": \"<string>\",\n            \"price\": {},\n            \"maxQuantity\": \"<string>\"\n          }\n        ]\n      },\n      \"quantity\": 123,\n      \"allowBuyerSelectedQuantity\": true,\n      \"billingCycleAnchorDate\": \"2023-12-25\",\n      \"billingStartDelayDays\": 123,\n      \"billingStartDelayMonths\": 123,\n      \"buyerSelectedQuantityMax\": 123,\n      \"buyerSelectedQuantityMin\": 123,\n      \"description\": \"<string>\",\n      \"discount\": 123,\n      \"discountPercentage\": 123,\n      \"externalId\": \"<string>\",\n      \"images\": \"<string>\",\n      \"isEditablePrice\": true,\n      \"isOptional\": true,\n      \"lineItemCurrencyCode\": \"<string>\",\n      \"positionOnQuote\": 123,\n      \"priceBookId\": \"<string>\",\n      \"productId\": \"<string>\",\n      \"productType\": \"<string>\",\n      \"recurringBillingEndDate\": \"2023-12-25\",\n      \"recurringBillingPeriod\": \"<string>\",\n      \"recurringBillingStartDate\": \"2023-12-25\",\n      \"richTextDescription\": \"<string>\",\n      \"sku\": \"<string>\",\n      \"variantId\": \"<string>\"\n    }\n  ],\n  \"locale\": {},\n  \"name\": \"<string>\",\n  \"netPaymentTerms\": {},\n  \"ownerId\": {},\n  \"paymentEnabled\": true,\n  \"poNumber\": {},\n  \"sellerCompanyAddress\": {},\n  \"sellerCompanyDomain\": {},\n  \"sellerCompanyName\": {},\n  \"sellerEmail\": {},\n  \"sellerFirstName\": {},\n  \"sellerLastName\": {},\n  \"sellerPhone\": {},\n  \"addressTypesToCollect\": [],\n  \"allowedPaymentMethods\": [],\n  \"customProperties\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "addressTypesToCollect": [],
  "allowedPaymentMethods": [],
  "automatedTaxesEnabled": true,
  "customProperties": {},
  "hubspotBillingEnabled": true,
  "id": "<string>",
  "lineItems": [
    {
      "id": "<string>",
      "name": "<string>",
      "pricing": {
        "prices": [
          {
            "currencyCode": "<string>",
            "price": 123,
            "maxQuantity": "<string>"
          }
        ]
      },
      "quantity": 123,
      "acv": 123,
      "allowBuyerSelectedQuantity": true,
      "amount": 123,
      "archived": true,
      "archivedAt": "2023-11-07T05:31:56Z",
      "arr": 123,
      "billingCycleAnchorDate": "2023-12-25",
      "billingPeriodEndDate": "2023-12-25",
      "billingPeriodStartDate": "2023-12-25",
      "billingStartDelayDays": 123,
      "billingStartDelayMonths": 123,
      "buyerSelectedQuantityMax": 123,
      "buyerSelectedQuantityMin": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "discount": 123,
      "discountPercentage": 123,
      "effectiveUnitPrice": 123,
      "externalId": "<string>",
      "images": "<string>",
      "isEditablePrice": true,
      "isOptional": true,
      "lineItemCurrencyCode": "<string>",
      "mrr": 123,
      "positionOnQuote": 123,
      "postTaxAmount": 123,
      "preDiscountAmount": 123,
      "price": 123,
      "priceBookId": "<string>",
      "productId": "<string>",
      "productType": "<string>",
      "rampKey": "<string>",
      "recurringBillingDayOfMonth": 123,
      "recurringBillingEndDate": "2023-12-25",
      "recurringBillingNumberOfPayments": 123,
      "recurringBillingPeriod": "<string>",
      "recurringBillingStartDate": "2023-12-25",
      "richTextDescription": "<string>",
      "sku": "<string>",
      "tax": 123,
      "tcv": 123,
      "termInMonths": 123,
      "tierAmount": 123,
      "totalDiscount": 123,
      "updatedAt": "2023-11-07T05:31:56Z",
      "variantId": "<string>"
    }
  ],
  "paymentEnabled": true,
  "storePaymentMethodAtCheckout": true,
  "allTransactionsFeeName": "<string>",
  "allTransactionsFeePercentage": 123,
  "annualContractValue": 123,
  "billingAddress": {
    "address": "<string>",
    "address2": "<string>",
    "city": "<string>",
    "country": "<string>",
    "countryCode": "<string>",
    "state": "<string>",
    "zip": "<string>"
  },
  "billingCompanyId": "<string>",
  "billingContactId": "<string>",
  "billingStartDateOverride": "2023-12-25",
  "cardFeeName": "<string>",
  "cardFeePercentage": 123,
  "contractEffectiveDate": "2023-12-25",
  "contractSourceId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "currencyCode": "<string>",
  "currentAnnualRecurringRevenue": 123,
  "currentMonthlyRecurringRevenue": 123,
  "dealId": "<string>",
  "directDebitFeeName": "<string>",
  "directDebitFeePercentage": 123,
  "discountCode": "<string>",
  "endDate": "2023-12-25",
  "externalPaymentMethodReferenceId": "<string>",
  "language": "<string>",
  "locale": "<string>",
  "name": "<string>",
  "netPaymentTerms": 123,
  "paymentMethod": "<string>",
  "poNumber": "<string>",
  "preTerminationContractValue": 123,
  "renewalContractId": "<string>",
  "renewalDate": "2023-12-25",
  "sellerCompanyAddress": {
    "address": "<string>",
    "address2": "<string>",
    "city": "<string>",
    "country": "<string>",
    "countryCode": "<string>",
    "state": "<string>",
    "zip": "<string>"
  },
  "sellerCompanyName": "<string>",
  "sellerEmail": "<string>",
  "sellerFirstName": "<string>",
  "sellerLastName": "<string>",
  "sellerPhoneNumber": "<string>",
  "startDate": "2023-12-25",
  "terminationDate": "2023-12-25",
  "totalBilledAmount": 123,
  "totalBilledAmountPreTax": 123,
  "totalCollectedFees": 123,
  "totalCollectedTaxes": 123,
  "totalContractValue": 123,
  "totalPaidAmount": 123,
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "message": "Invalid input (details will vary based on the error)",
  "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
  "category": "VALIDATION_ERROR",
  "links": {
    "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
  }
}

POST

commerce

contracts

2026-09-beta

contracts

Create contract

curl --request POST \
  --url https://api.hubapi.com/commerce/contracts/2026-09-beta/contracts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "automatedTaxesEnabled": {},
  "billingAddress": {},
  "billingCompanyId": {},
  "billingContactId": "<string>",
  "billingStartDateOverride": {},
  "contractEffectiveDate": "2023-12-25",
  "currencyCode": "<string>",
  "dealId": {},
  "externalPaymentMethodReferenceId": {},
  "hubspotBillingEnabled": true,
  "lineItems": [
    {
      "mode": "CUSTOM",
      "name": "<string>",
      "pricing": {
        "prices": [
          {
            "currencyCode": "<string>",
            "price": {},
            "maxQuantity": "<string>"
          }
        ]
      },
      "quantity": 123,
      "allowBuyerSelectedQuantity": true,
      "billingCycleAnchorDate": "2023-12-25",
      "billingStartDelayDays": 123,
      "billingStartDelayMonths": 123,
      "buyerSelectedQuantityMax": 123,
      "buyerSelectedQuantityMin": 123,
      "description": "<string>",
      "discount": 123,
      "discountPercentage": 123,
      "externalId": "<string>",
      "images": "<string>",
      "isEditablePrice": true,
      "isOptional": true,
      "lineItemCurrencyCode": "<string>",
      "positionOnQuote": 123,
      "priceBookId": "<string>",
      "productId": "<string>",
      "productType": "<string>",
      "recurringBillingEndDate": "2023-12-25",
      "recurringBillingPeriod": "<string>",
      "recurringBillingStartDate": "2023-12-25",
      "richTextDescription": "<string>",
      "sku": "<string>",
      "variantId": "<string>"
    }
  ],
  "locale": {},
  "name": "<string>",
  "netPaymentTerms": {},
  "ownerId": {},
  "paymentEnabled": true,
  "poNumber": {},
  "sellerCompanyAddress": {},
  "sellerCompanyDomain": {},
  "sellerCompanyName": {},
  "sellerEmail": {},
  "sellerFirstName": {},
  "sellerLastName": {},
  "sellerPhone": {},
  "addressTypesToCollect": [],
  "allowedPaymentMethods": [],
  "customProperties": {}
}
'

import requests

url = "https://api.hubapi.com/commerce/contracts/2026-09-beta/contracts"

payload = {
    "automatedTaxesEnabled": {},
    "billingAddress": {},
    "billingCompanyId": {},
    "billingContactId": "<string>",
    "billingStartDateOverride": {},
    "contractEffectiveDate": "2023-12-25",
    "currencyCode": "<string>",
    "dealId": {},
    "externalPaymentMethodReferenceId": {},
    "hubspotBillingEnabled": True,
    "lineItems": [
        {
            "mode": "CUSTOM",
            "name": "<string>",
            "pricing": { "prices": [
                    {
                        "currencyCode": "<string>",
                        "price": {},
                        "maxQuantity": "<string>"
                    }
                ] },
            "quantity": 123,
            "allowBuyerSelectedQuantity": True,
            "billingCycleAnchorDate": "2023-12-25",
            "billingStartDelayDays": 123,
            "billingStartDelayMonths": 123,
            "buyerSelectedQuantityMax": 123,
            "buyerSelectedQuantityMin": 123,
            "description": "<string>",
            "discount": 123,
            "discountPercentage": 123,
            "externalId": "<string>",
            "images": "<string>",
            "isEditablePrice": True,
            "isOptional": True,
            "lineItemCurrencyCode": "<string>",
            "positionOnQuote": 123,
            "priceBookId": "<string>",
            "productId": "<string>",
            "productType": "<string>",
            "recurringBillingEndDate": "2023-12-25",
            "recurringBillingPeriod": "<string>",
            "recurringBillingStartDate": "2023-12-25",
            "richTextDescription": "<string>",
            "sku": "<string>",
            "variantId": "<string>"
        }
    ],
    "locale": {},
    "name": "<string>",
    "netPaymentTerms": {},
    "ownerId": {},
    "paymentEnabled": True,
    "poNumber": {},
    "sellerCompanyAddress": {},
    "sellerCompanyDomain": {},
    "sellerCompanyName": {},
    "sellerEmail": {},
    "sellerFirstName": {},
    "sellerLastName": {},
    "sellerPhone": {},
    "addressTypesToCollect": [],
    "allowedPaymentMethods": [],
    "customProperties": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    automatedTaxesEnabled: {},
    billingAddress: {},
    billingCompanyId: {},
    billingContactId: '<string>',
    billingStartDateOverride: {},
    contractEffectiveDate: '2023-12-25',
    currencyCode: '<string>',
    dealId: {},
    externalPaymentMethodReferenceId: {},
    hubspotBillingEnabled: true,
    lineItems: [
      {
        mode: 'CUSTOM',
        name: '<string>',
        pricing: {prices: [{currencyCode: '<string>', price: {}, maxQuantity: '<string>'}]},
        quantity: 123,
        allowBuyerSelectedQuantity: true,
        billingCycleAnchorDate: '2023-12-25',
        billingStartDelayDays: 123,
        billingStartDelayMonths: 123,
        buyerSelectedQuantityMax: 123,
        buyerSelectedQuantityMin: 123,
        description: '<string>',
        discount: 123,
        discountPercentage: 123,
        externalId: '<string>',
        images: '<string>',
        isEditablePrice: true,
        isOptional: true,
        lineItemCurrencyCode: '<string>',
        positionOnQuote: 123,
        priceBookId: '<string>',
        productId: '<string>',
        productType: '<string>',
        recurringBillingEndDate: '2023-12-25',
        recurringBillingPeriod: '<string>',
        recurringBillingStartDate: '2023-12-25',
        richTextDescription: '<string>',
        sku: '<string>',
        variantId: '<string>'
      }
    ],
    locale: {},
    name: '<string>',
    netPaymentTerms: {},
    ownerId: {},
    paymentEnabled: true,
    poNumber: {},
    sellerCompanyAddress: {},
    sellerCompanyDomain: {},
    sellerCompanyName: {},
    sellerEmail: {},
    sellerFirstName: {},
    sellerLastName: {},
    sellerPhone: {},
    addressTypesToCollect: [],
    allowedPaymentMethods: [],
    customProperties: {}
  })
};

fetch('https://api.hubapi.com/commerce/contracts/2026-09-beta/contracts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hubapi.com/commerce/contracts/2026-09-beta/contracts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'automatedTaxesEnabled' => [
        
    ],
    'billingAddress' => [
        
    ],
    'billingCompanyId' => [
        
    ],
    'billingContactId' => '<string>',
    'billingStartDateOverride' => [
        
    ],
    'contractEffectiveDate' => '2023-12-25',
    'currencyCode' => '<string>',
    'dealId' => [
        
    ],
    'externalPaymentMethodReferenceId' => [
        
    ],
    'hubspotBillingEnabled' => true,
    'lineItems' => [
        [
                'mode' => 'CUSTOM',
                'name' => '<string>',
                'pricing' => [
                                'prices' => [
                                                                [
                                                                                                                                'currencyCode' => '<string>',
                                                                                                                                'price' => [
                                                                                                                                                                                                                                                                
                                                                                                                                ],
                                                                                                                                'maxQuantity' => '<string>'
                                                                ]
                                ]
                ],
                'quantity' => 123,
                'allowBuyerSelectedQuantity' => true,
                'billingCycleAnchorDate' => '2023-12-25',
                'billingStartDelayDays' => 123,
                'billingStartDelayMonths' => 123,
                'buyerSelectedQuantityMax' => 123,
                'buyerSelectedQuantityMin' => 123,
                'description' => '<string>',
                'discount' => 123,
                'discountPercentage' => 123,
                'externalId' => '<string>',
                'images' => '<string>',
                'isEditablePrice' => true,
                'isOptional' => true,
                'lineItemCurrencyCode' => '<string>',
                'positionOnQuote' => 123,
                'priceBookId' => '<string>',
                'productId' => '<string>',
                'productType' => '<string>',
                'recurringBillingEndDate' => '2023-12-25',
                'recurringBillingPeriod' => '<string>',
                'recurringBillingStartDate' => '2023-12-25',
                'richTextDescription' => '<string>',
                'sku' => '<string>',
                'variantId' => '<string>'
        ]
    ],
    'locale' => [
        
    ],
    'name' => '<string>',
    'netPaymentTerms' => [
        
    ],
    'ownerId' => [
        
    ],
    'paymentEnabled' => true,
    'poNumber' => [
        
    ],
    'sellerCompanyAddress' => [
        
    ],
    'sellerCompanyDomain' => [
        
    ],
    'sellerCompanyName' => [
        
    ],
    'sellerEmail' => [
        
    ],
    'sellerFirstName' => [
        
    ],
    'sellerLastName' => [
        
    ],
    'sellerPhone' => [
        
    ],
    'addressTypesToCollect' => [
        
    ],
    'allowedPaymentMethods' => [
        
    ],
    'customProperties' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hubapi.com/commerce/contracts/2026-09-beta/contracts"

	payload := strings.NewReader("{\n  \"automatedTaxesEnabled\": {},\n  \"billingAddress\": {},\n  \"billingCompanyId\": {},\n  \"billingContactId\": \"<string>\",\n  \"billingStartDateOverride\": {},\n  \"contractEffectiveDate\": \"2023-12-25\",\n  \"currencyCode\": \"<string>\",\n  \"dealId\": {},\n  \"externalPaymentMethodReferenceId\": {},\n  \"hubspotBillingEnabled\": true,\n  \"lineItems\": [\n    {\n      \"mode\": \"CUSTOM\",\n      \"name\": \"<string>\",\n      \"pricing\": {\n        \"prices\": [\n          {\n            \"currencyCode\": \"<string>\",\n            \"price\": {},\n            \"maxQuantity\": \"<string>\"\n          }\n        ]\n      },\n      \"quantity\": 123,\n      \"allowBuyerSelectedQuantity\": true,\n      \"billingCycleAnchorDate\": \"2023-12-25\",\n      \"billingStartDelayDays\": 123,\n      \"billingStartDelayMonths\": 123,\n      \"buyerSelectedQuantityMax\": 123,\n      \"buyerSelectedQuantityMin\": 123,\n      \"description\": \"<string>\",\n      \"discount\": 123,\n      \"discountPercentage\": 123,\n      \"externalId\": \"<string>\",\n      \"images\": \"<string>\",\n      \"isEditablePrice\": true,\n      \"isOptional\": true,\n      \"lineItemCurrencyCode\": \"<string>\",\n      \"positionOnQuote\": 123,\n      \"priceBookId\": \"<string>\",\n      \"productId\": \"<string>\",\n      \"productType\": \"<string>\",\n      \"recurringBillingEndDate\": \"2023-12-25\",\n      \"recurringBillingPeriod\": \"<string>\",\n      \"recurringBillingStartDate\": \"2023-12-25\",\n      \"richTextDescription\": \"<string>\",\n      \"sku\": \"<string>\",\n      \"variantId\": \"<string>\"\n    }\n  ],\n  \"locale\": {},\n  \"name\": \"<string>\",\n  \"netPaymentTerms\": {},\n  \"ownerId\": {},\n  \"paymentEnabled\": true,\n  \"poNumber\": {},\n  \"sellerCompanyAddress\": {},\n  \"sellerCompanyDomain\": {},\n  \"sellerCompanyName\": {},\n  \"sellerEmail\": {},\n  \"sellerFirstName\": {},\n  \"sellerLastName\": {},\n  \"sellerPhone\": {},\n  \"addressTypesToCollect\": [],\n  \"allowedPaymentMethods\": [],\n  \"customProperties\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hubapi.com/commerce/contracts/2026-09-beta/contracts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"automatedTaxesEnabled\": {},\n  \"billingAddress\": {},\n  \"billingCompanyId\": {},\n  \"billingContactId\": \"<string>\",\n  \"billingStartDateOverride\": {},\n  \"contractEffectiveDate\": \"2023-12-25\",\n  \"currencyCode\": \"<string>\",\n  \"dealId\": {},\n  \"externalPaymentMethodReferenceId\": {},\n  \"hubspotBillingEnabled\": true,\n  \"lineItems\": [\n    {\n      \"mode\": \"CUSTOM\",\n      \"name\": \"<string>\",\n      \"pricing\": {\n        \"prices\": [\n          {\n            \"currencyCode\": \"<string>\",\n            \"price\": {},\n            \"maxQuantity\": \"<string>\"\n          }\n        ]\n      },\n      \"quantity\": 123,\n      \"allowBuyerSelectedQuantity\": true,\n      \"billingCycleAnchorDate\": \"2023-12-25\",\n      \"billingStartDelayDays\": 123,\n      \"billingStartDelayMonths\": 123,\n      \"buyerSelectedQuantityMax\": 123,\n      \"buyerSelectedQuantityMin\": 123,\n      \"description\": \"<string>\",\n      \"discount\": 123,\n      \"discountPercentage\": 123,\n      \"externalId\": \"<string>\",\n      \"images\": \"<string>\",\n      \"isEditablePrice\": true,\n      \"isOptional\": true,\n      \"lineItemCurrencyCode\": \"<string>\",\n      \"positionOnQuote\": 123,\n      \"priceBookId\": \"<string>\",\n      \"productId\": \"<string>\",\n      \"productType\": \"<string>\",\n      \"recurringBillingEndDate\": \"2023-12-25\",\n      \"recurringBillingPeriod\": \"<string>\",\n      \"recurringBillingStartDate\": \"2023-12-25\",\n      \"richTextDescription\": \"<string>\",\n      \"sku\": \"<string>\",\n      \"variantId\": \"<string>\"\n    }\n  ],\n  \"locale\": {},\n  \"name\": \"<string>\",\n  \"netPaymentTerms\": {},\n  \"ownerId\": {},\n  \"paymentEnabled\": true,\n  \"poNumber\": {},\n  \"sellerCompanyAddress\": {},\n  \"sellerCompanyDomain\": {},\n  \"sellerCompanyName\": {},\n  \"sellerEmail\": {},\n  \"sellerFirstName\": {},\n  \"sellerLastName\": {},\n  \"sellerPhone\": {},\n  \"addressTypesToCollect\": [],\n  \"allowedPaymentMethods\": [],\n  \"customProperties\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/commerce/contracts/2026-09-beta/contracts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"automatedTaxesEnabled\": {},\n  \"billingAddress\": {},\n  \"billingCompanyId\": {},\n  \"billingContactId\": \"<string>\",\n  \"billingStartDateOverride\": {},\n  \"contractEffectiveDate\": \"2023-12-25\",\n  \"currencyCode\": \"<string>\",\n  \"dealId\": {},\n  \"externalPaymentMethodReferenceId\": {},\n  \"hubspotBillingEnabled\": true,\n  \"lineItems\": [\n    {\n      \"mode\": \"CUSTOM\",\n      \"name\": \"<string>\",\n      \"pricing\": {\n        \"prices\": [\n          {\n            \"currencyCode\": \"<string>\",\n            \"price\": {},\n            \"maxQuantity\": \"<string>\"\n          }\n        ]\n      },\n      \"quantity\": 123,\n      \"allowBuyerSelectedQuantity\": true,\n      \"billingCycleAnchorDate\": \"2023-12-25\",\n      \"billingStartDelayDays\": 123,\n      \"billingStartDelayMonths\": 123,\n      \"buyerSelectedQuantityMax\": 123,\n      \"buyerSelectedQuantityMin\": 123,\n      \"description\": \"<string>\",\n      \"discount\": 123,\n      \"discountPercentage\": 123,\n      \"externalId\": \"<string>\",\n      \"images\": \"<string>\",\n      \"isEditablePrice\": true,\n      \"isOptional\": true,\n      \"lineItemCurrencyCode\": \"<string>\",\n      \"positionOnQuote\": 123,\n      \"priceBookId\": \"<string>\",\n      \"productId\": \"<string>\",\n      \"productType\": \"<string>\",\n      \"recurringBillingEndDate\": \"2023-12-25\",\n      \"recurringBillingPeriod\": \"<string>\",\n      \"recurringBillingStartDate\": \"2023-12-25\",\n      \"richTextDescription\": \"<string>\",\n      \"sku\": \"<string>\",\n      \"variantId\": \"<string>\"\n    }\n  ],\n  \"locale\": {},\n  \"name\": \"<string>\",\n  \"netPaymentTerms\": {},\n  \"ownerId\": {},\n  \"paymentEnabled\": true,\n  \"poNumber\": {},\n  \"sellerCompanyAddress\": {},\n  \"sellerCompanyDomain\": {},\n  \"sellerCompanyName\": {},\n  \"sellerEmail\": {},\n  \"sellerFirstName\": {},\n  \"sellerLastName\": {},\n  \"sellerPhone\": {},\n  \"addressTypesToCollect\": [],\n  \"allowedPaymentMethods\": [],\n  \"customProperties\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "addressTypesToCollect": [],
  "allowedPaymentMethods": [],
  "automatedTaxesEnabled": true,
  "customProperties": {},
  "hubspotBillingEnabled": true,
  "id": "<string>",
  "lineItems": [
    {
      "id": "<string>",
      "name": "<string>",
      "pricing": {
        "prices": [
          {
            "currencyCode": "<string>",
            "price": 123,
            "maxQuantity": "<string>"
          }
        ]
      },
      "quantity": 123,
      "acv": 123,
      "allowBuyerSelectedQuantity": true,
      "amount": 123,
      "archived": true,
      "archivedAt": "2023-11-07T05:31:56Z",
      "arr": 123,
      "billingCycleAnchorDate": "2023-12-25",
      "billingPeriodEndDate": "2023-12-25",
      "billingPeriodStartDate": "2023-12-25",
      "billingStartDelayDays": 123,
      "billingStartDelayMonths": 123,
      "buyerSelectedQuantityMax": 123,
      "buyerSelectedQuantityMin": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "discount": 123,
      "discountPercentage": 123,
      "effectiveUnitPrice": 123,
      "externalId": "<string>",
      "images": "<string>",
      "isEditablePrice": true,
      "isOptional": true,
      "lineItemCurrencyCode": "<string>",
      "mrr": 123,
      "positionOnQuote": 123,
      "postTaxAmount": 123,
      "preDiscountAmount": 123,
      "price": 123,
      "priceBookId": "<string>",
      "productId": "<string>",
      "productType": "<string>",
      "rampKey": "<string>",
      "recurringBillingDayOfMonth": 123,
      "recurringBillingEndDate": "2023-12-25",
      "recurringBillingNumberOfPayments": 123,
      "recurringBillingPeriod": "<string>",
      "recurringBillingStartDate": "2023-12-25",
      "richTextDescription": "<string>",
      "sku": "<string>",
      "tax": 123,
      "tcv": 123,
      "termInMonths": 123,
      "tierAmount": 123,
      "totalDiscount": 123,
      "updatedAt": "2023-11-07T05:31:56Z",
      "variantId": "<string>"
    }
  ],
  "paymentEnabled": true,
  "storePaymentMethodAtCheckout": true,
  "allTransactionsFeeName": "<string>",
  "allTransactionsFeePercentage": 123,
  "annualContractValue": 123,
  "billingAddress": {
    "address": "<string>",
    "address2": "<string>",
    "city": "<string>",
    "country": "<string>",
    "countryCode": "<string>",
    "state": "<string>",
    "zip": "<string>"
  },
  "billingCompanyId": "<string>",
  "billingContactId": "<string>",
  "billingStartDateOverride": "2023-12-25",
  "cardFeeName": "<string>",
  "cardFeePercentage": 123,
  "contractEffectiveDate": "2023-12-25",
  "contractSourceId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "currencyCode": "<string>",
  "currentAnnualRecurringRevenue": 123,
  "currentMonthlyRecurringRevenue": 123,
  "dealId": "<string>",
  "directDebitFeeName": "<string>",
  "directDebitFeePercentage": 123,
  "discountCode": "<string>",
  "endDate": "2023-12-25",
  "externalPaymentMethodReferenceId": "<string>",
  "language": "<string>",
  "locale": "<string>",
  "name": "<string>",
  "netPaymentTerms": 123,
  "paymentMethod": "<string>",
  "poNumber": "<string>",
  "preTerminationContractValue": 123,
  "renewalContractId": "<string>",
  "renewalDate": "2023-12-25",
  "sellerCompanyAddress": {
    "address": "<string>",
    "address2": "<string>",
    "city": "<string>",
    "country": "<string>",
    "countryCode": "<string>",
    "state": "<string>",
    "zip": "<string>"
  },
  "sellerCompanyName": "<string>",
  "sellerEmail": "<string>",
  "sellerFirstName": "<string>",
  "sellerLastName": "<string>",
  "sellerPhoneNumber": "<string>",
  "startDate": "2023-12-25",
  "terminationDate": "2023-12-25",
  "totalBilledAmount": 123,
  "totalBilledAmountPreTax": 123,
  "totalCollectedFees": 123,
  "totalCollectedTaxes": 123,
  "totalContractValue": 123,
  "totalPaidAmount": 123,
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "message": "Invalid input (details will vary based on the error)",
  "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
  "category": "VALIDATION_ERROR",
  "links": {
    "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
  }
}

Supported products

Required Scopes

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

automatedTaxesEnabled

object

required

An object indicating whether automated taxes are enabled for the contract.

billingAddress

object

required

An object representing the billing address for the contract.

billingCompanyId

object

required

An object representing the ID of the billing company.

billingContactId

string

required

A string representing the ID of the billing contact.

billingStartDateOverride

object

required

An object representing an override for the billing start date.

contractEffectiveDate

string<date>

required

A string representing the effective date of the contract, in date format.

currencyCode

string

required

A string representing the currency code for the contract.

dealId

object

required

An object representing the ID of the associated deal.

externalPaymentMethodReferenceId

object

required

An object representing an external reference ID for the payment method.

hubspotBillingEnabled

boolean

required

A boolean indicating whether HubSpot billing is enabled for the contract.

lineItems

(CUSTOM · object | FROM_PRODUCT · object | CLONE · object)[]

required

An array of line items included in the contract, which can be custom, from a product, or cloned.

CUSTOM
FROM_PRODUCT
CLONE

Show child attributes

locale

object

required

An object representing the locale settings for the contract.

name

string

required

A string representing the name of the contract.

netPaymentTerms

object

required

An object representing the net payment terms for the contract.

ownerId

object

required

An object representing the ID of the contract owner.

paymentEnabled

boolean

required

A boolean indicating whether payment is enabled for the contract.

poNumber

object

required

An object representing the purchase order number associated with the contract.

sellerCompanyAddress

object

required

An object representing the address of the seller's company.

sellerCompanyDomain

object

required

An object representing the domain of the seller's company.

sellerCompanyName

object

required

An object representing the name of the seller's company.

sellerEmail

object

required

An object representing the email address of the seller.

sellerFirstName

object

required

An object representing the first name of the seller.

sellerLastName

object

required

An object representing the last name of the seller.

sellerPhone

object

required

An object representing the phone number of the seller.

addressTypesToCollect

enum<string>[]

An array specifying the types of addresses to collect, with possible values including 'BILLING_ADDRESS' and 'SHIPPING_ADDRESS'.

Available options:

BILLING_ADDRESS,

SHIPPING_ADDRESS

allowedPaymentMethods

enum<string>[]

An array specifying the allowed payment methods, with possible values including 'CREDIT_OR_DEBIT_CARD', 'ACH', 'SEPA', 'BACS', and 'PADS'.

Available options:

CREDIT_OR_DEBIT_CARD,

ACH,

SEPA,

BACS,

PADS

collectionProcess

enum<string>

A string indicating the collection process for payments, with possible values including 'MANUAL_PAYMENTS' and 'AUTOMATIC_PAYMENTS'.

Available options:

AUTOMATIC_PAYMENTS,

MANUAL_PAYMENTS

customProperties

object

An object containing custom properties for the contract, with each property being a key-value pair.

Show child attributes

Response

successful operation

addressTypesToCollect

enum<string>[]

required

An array indicating the types of addresses to collect. Valid values include 'BILLING_ADDRESS' and 'SHIPPING_ADDRESS'.

Available options:

BILLING_ADDRESS,

SHIPPING_ADDRESS

allowedPaymentMethods

enum<string>[]

required

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

Available options:

CREDIT_OR_DEBIT_CARD,

ACH,

SEPA,

BACS,

PADS

automatedTaxesEnabled

boolean

required

Indicates whether automated taxes are enabled for the contract.

customProperties

object

required

A map of custom property names to their values for the contract.

Show child attributes

hubspotBillingEnabled

boolean

required

Indicates whether HubSpot billing is enabled for the contract.

string

required

The unique identifier for the contract.

lineItems

object[]

required

An array of line items included in the contract.

Show child attributes

paymentEnabled

boolean

required

Indicates whether payment is enabled for the contract.

status

enum<string>

required

The current status of the contract. Valid values include 'DRAFT', 'ACTIVE', 'PAUSED', 'COMPLETED', and 'TERMINATED'.

Available options:

ACTIVE,

COMPLETED,

DRAFT,

PAUSED,

TERMINATED

storePaymentMethodAtCheckout

boolean

required

Indicates whether the payment method should be stored at checkout.

allTransactionsFeeName

string

The name of the fee applied to all transactions.

allTransactionsFeePercentage

number

The percentage fee applied to all transactions.

annualContractValue

number

The annual value of the contract, represented as a number.

billingAddress

object

Show child attributes

billingCompanyId

string

The unique identifier for the billing company associated with the contract.

billingContactId

string

The unique identifier for the billing contact associated with the contract.

billingStartDateOverride

string<date>

An override for the billing start date, in YYYY-MM-DD format.

cardFeeName

string

The name of the fee applied to card transactions.

cardFeePercentage

number

The percentage fee applied to card transactions.

collectionProcess

enum<string>

The process for collecting payments. Valid values include 'MANUAL_PAYMENTS' and 'AUTOMATIC_PAYMENTS'.

Available options:

AUTOMATIC_PAYMENTS,

MANUAL_PAYMENTS

contractEffectiveDate

string<date>

The effective date of the contract, in YYYY-MM-DD format.

contractSourceId

string

The unique identifier for the source of the contract.

createdAt

string<date-time>

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

currencyCode

string

The currency code used for the contract, represented as a string.

currentAnnualRecurringRevenue

number

The current annual recurring revenue for the contract, represented as a number.

currentMonthlyRecurringRevenue

number

The current monthly recurring revenue for the contract, represented as a number.

dealId

string

The unique identifier for the deal associated with the contract.

directDebitFeeName

string

The name of the fee applied to direct debit transactions.

directDebitFeePercentage

number

The percentage fee applied to direct debit transactions.

discountCode

string

The discount code applied to the contract.

endDate

string<date>

The end date of the contract, in YYYY-MM-DD format.

externalPaymentMethodReferenceId

string

The external reference ID for the payment method used in the contract.

language

string

The language used for the contract.

locale

string

The locale setting for the contract.

name

string

The name of the contract.

netPaymentTerms

integer<int32>

The net payment terms for the contract, represented as an integer.

paymentMethod

string

The payment method used for the contract.

poNumber

string

The purchase order number associated with the contract.

preTerminationContractValue

number

The value of the contract before termination, represented as a number.

renewalContractId

string

The unique identifier for the renewal contract.

renewalDate

string<date>

The renewal date of the contract, in YYYY-MM-DD format.

sellerCompanyAddress

object

Show child attributes

sellerCompanyName

string

The name of the seller's company.

sellerEmail

string

The email address of the seller.

sellerFirstName

string

The first name of the seller.

sellerLastName

string

The last name of the seller.

sellerPhoneNumber

string

The phone number of the seller.

startDate

string<date>

The start date of the contract, in YYYY-MM-DD format.

terminationDate

string<date>

The termination date of the contract, in YYYY-MM-DD format.

totalBilledAmount

number

The total amount billed under the contract, represented as a number.

totalBilledAmountPreTax

number

The total amount billed under the contract before tax, represented as a number.

totalCollectedFees

number

The total fees collected under the contract, represented as a number.

totalCollectedTaxes

number

The total taxes collected under the contract, represented as a number.

totalContractValue

number

The total value of the contract, represented as a number.

totalPaidAmount

number

The total amount paid under the contract, represented as a number.

updatedAt

string<date-time>

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

Last modified on August 6, 2026

⌘I