Create contract

curl --request POST \
  --url https://api.hubapi.com/commerce/contracts/2027-03-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": 123
          }
        ]
      },
      "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>",
      "taxCategory": "<string>",
      "taxRateGroupId": "<string>",
      "variantId": "<string>"
    }
  ],
  "locale": {},
  "name": "<string>",
  "netPaymentTerms": {},
  "ownerId": {},
  "paymentEnabled": true,
  "poNumber": {},
  "sellerCompanyAddress": {},
  "sellerCompanyDomain": {},
  "sellerCompanyName": {},
  "sellerEmail": {},
  "sellerFirstName": {},
  "sellerLastName": {},
  "sellerPhone": {},
  "addressTypesToCollect": [],
  "allowedPaymentMethods": [],
  "businessUnitId": "<string>",
  "customProperties": {}
}
'

import requests

url = "https://api.hubapi.com/commerce/contracts/2027-03-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": 123
                    }
                ] },
            "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>",
            "taxCategory": "<string>",
            "taxRateGroupId": "<string>",
            "variantId": "<string>"
        }
    ],
    "locale": {},
    "name": "<string>",
    "netPaymentTerms": {},
    "ownerId": {},
    "paymentEnabled": True,
    "poNumber": {},
    "sellerCompanyAddress": {},
    "sellerCompanyDomain": {},
    "sellerCompanyName": {},
    "sellerEmail": {},
    "sellerFirstName": {},
    "sellerLastName": {},
    "sellerPhone": {},
    "addressTypesToCollect": [],
    "allowedPaymentMethods": [],
    "businessUnitId": "<string>",
    "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: 123}]},
        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>',
        taxCategory: '<string>',
        taxRateGroupId: '<string>',
        variantId: '<string>'
      }
    ],
    locale: {},
    name: '<string>',
    netPaymentTerms: {},
    ownerId: {},
    paymentEnabled: true,
    poNumber: {},
    sellerCompanyAddress: {},
    sellerCompanyDomain: {},
    sellerCompanyName: {},
    sellerEmail: {},
    sellerFirstName: {},
    sellerLastName: {},
    sellerPhone: {},
    addressTypesToCollect: [],
    allowedPaymentMethods: [],
    businessUnitId: '<string>',
    customProperties: {}
  })
};

fetch('https://api.hubapi.com/commerce/contracts/2027-03-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/2027-03-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' => 123
                                                                ]
                                ]
                ],
                '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>',
                'taxCategory' => '<string>',
                'taxRateGroupId' => '<string>',
                'variantId' => '<string>'
        ]
    ],
    'locale' => [
        
    ],
    'name' => '<string>',
    'netPaymentTerms' => [
        
    ],
    'ownerId' => [
        
    ],
    'paymentEnabled' => true,
    'poNumber' => [
        
    ],
    'sellerCompanyAddress' => [
        
    ],
    'sellerCompanyDomain' => [
        
    ],
    'sellerCompanyName' => [
        
    ],
    'sellerEmail' => [
        
    ],
    'sellerFirstName' => [
        
    ],
    'sellerLastName' => [
        
    ],
    'sellerPhone' => [
        
    ],
    'addressTypesToCollect' => [
        
    ],
    'allowedPaymentMethods' => [
        
    ],
    'businessUnitId' => '<string>',
    '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/2027-03-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\": 123\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      \"taxCategory\": \"<string>\",\n      \"taxRateGroupId\": \"<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  \"businessUnitId\": \"<string>\",\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/2027-03-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\": 123\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      \"taxCategory\": \"<string>\",\n      \"taxRateGroupId\": \"<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  \"businessUnitId\": \"<string>\",\n  \"customProperties\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/commerce/contracts/2027-03-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\": 123\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      \"taxCategory\": \"<string>\",\n      \"taxRateGroupId\": \"<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  \"businessUnitId\": \"<string>\",\n  \"customProperties\": {}\n}"

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

{
  "addressTypesToCollect": [
    "BILLING_ADDRESS"
  ],
  "allowedPaymentMethods": [
    "CREDIT_OR_DEBIT_CARD"
  ],
  "automatedTaxesEnabled": true,
  "customProperties": {},
  "hubspotBillingEnabled": true,
  "id": "<string>",
  "lineItems": [
    {
      "id": "<string>",
      "name": "<string>",
      "pricing": {
        "prices": [
          {
            "currencyCode": "<string>",
            "price": 123,
            "maxQuantity": 123
          }
        ],
        "pricingModel": "FLAT"
      },
      "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,
      "billingStartDelayType": "HS_BILLING_START_DELAY_DAYS",
      "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,
      "isParent": true,
      "lineItemCurrencyCode": "<string>",
      "mrr": 123,
      "parentLineItemId": "<string>",
      "positionOnQuote": 123,
      "postTaxAmount": 123,
      "preDiscountAmount": 123,
      "price": 123,
      "priceBookId": "<string>",
      "pricingModel": "FLAT",
      "productId": "<string>",
      "productType": "<string>",
      "rampKey": "<string>",
      "recurringBillingDayOfMonth": 123,
      "recurringBillingEndDate": "2023-12-25",
      "recurringBillingFrequency": "ANNUALLY",
      "recurringBillingNumberOfPayments": 123,
      "recurringBillingPeriod": "<string>",
      "recurringBillingStartDate": "2023-12-25",
      "recurringBillingTerms": "AUTOMATICALLY_RENEW",
      "richTextDescription": "<string>",
      "sku": "<string>",
      "tax": 123,
      "taxAmount": 123,
      "taxCategory": "<string>",
      "taxRateGroupId": "<string>",
      "tcv": 123,
      "termInMonths": 123,
      "tierAmount": 123,
      "totalDiscount": 123,
      "updatedAt": "2023-11-07T05:31:56Z",
      "variantId": "<string>"
    }
  ],
  "paymentEnabled": true,
  "status": "ACTIVE",
  "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",
  "businessUnitId": "<string>",
  "cardFeeName": "<string>",
  "cardFeePercentage": 123,
  "collectionProcess": "AUTOMATIC_PAYMENTS",
  "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

2027-03-beta

contracts

Create contract

curl --request POST \
  --url https://api.hubapi.com/commerce/contracts/2027-03-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": 123
          }
        ]
      },
      "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>",
      "taxCategory": "<string>",
      "taxRateGroupId": "<string>",
      "variantId": "<string>"
    }
  ],
  "locale": {},
  "name": "<string>",
  "netPaymentTerms": {},
  "ownerId": {},
  "paymentEnabled": true,
  "poNumber": {},
  "sellerCompanyAddress": {},
  "sellerCompanyDomain": {},
  "sellerCompanyName": {},
  "sellerEmail": {},
  "sellerFirstName": {},
  "sellerLastName": {},
  "sellerPhone": {},
  "addressTypesToCollect": [],
  "allowedPaymentMethods": [],
  "businessUnitId": "<string>",
  "customProperties": {}
}
'

import requests

url = "https://api.hubapi.com/commerce/contracts/2027-03-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": 123
                    }
                ] },
            "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>",
            "taxCategory": "<string>",
            "taxRateGroupId": "<string>",
            "variantId": "<string>"
        }
    ],
    "locale": {},
    "name": "<string>",
    "netPaymentTerms": {},
    "ownerId": {},
    "paymentEnabled": True,
    "poNumber": {},
    "sellerCompanyAddress": {},
    "sellerCompanyDomain": {},
    "sellerCompanyName": {},
    "sellerEmail": {},
    "sellerFirstName": {},
    "sellerLastName": {},
    "sellerPhone": {},
    "addressTypesToCollect": [],
    "allowedPaymentMethods": [],
    "businessUnitId": "<string>",
    "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: 123}]},
        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>',
        taxCategory: '<string>',
        taxRateGroupId: '<string>',
        variantId: '<string>'
      }
    ],
    locale: {},
    name: '<string>',
    netPaymentTerms: {},
    ownerId: {},
    paymentEnabled: true,
    poNumber: {},
    sellerCompanyAddress: {},
    sellerCompanyDomain: {},
    sellerCompanyName: {},
    sellerEmail: {},
    sellerFirstName: {},
    sellerLastName: {},
    sellerPhone: {},
    addressTypesToCollect: [],
    allowedPaymentMethods: [],
    businessUnitId: '<string>',
    customProperties: {}
  })
};

fetch('https://api.hubapi.com/commerce/contracts/2027-03-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/2027-03-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' => 123
                                                                ]
                                ]
                ],
                '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>',
                'taxCategory' => '<string>',
                'taxRateGroupId' => '<string>',
                'variantId' => '<string>'
        ]
    ],
    'locale' => [
        
    ],
    'name' => '<string>',
    'netPaymentTerms' => [
        
    ],
    'ownerId' => [
        
    ],
    'paymentEnabled' => true,
    'poNumber' => [
        
    ],
    'sellerCompanyAddress' => [
        
    ],
    'sellerCompanyDomain' => [
        
    ],
    'sellerCompanyName' => [
        
    ],
    'sellerEmail' => [
        
    ],
    'sellerFirstName' => [
        
    ],
    'sellerLastName' => [
        
    ],
    'sellerPhone' => [
        
    ],
    'addressTypesToCollect' => [
        
    ],
    'allowedPaymentMethods' => [
        
    ],
    'businessUnitId' => '<string>',
    '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/2027-03-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\": 123\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      \"taxCategory\": \"<string>\",\n      \"taxRateGroupId\": \"<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  \"businessUnitId\": \"<string>\",\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/2027-03-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\": 123\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      \"taxCategory\": \"<string>\",\n      \"taxRateGroupId\": \"<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  \"businessUnitId\": \"<string>\",\n  \"customProperties\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/commerce/contracts/2027-03-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\": 123\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      \"taxCategory\": \"<string>\",\n      \"taxRateGroupId\": \"<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  \"businessUnitId\": \"<string>\",\n  \"customProperties\": {}\n}"

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

{
  "addressTypesToCollect": [
    "BILLING_ADDRESS"
  ],
  "allowedPaymentMethods": [
    "CREDIT_OR_DEBIT_CARD"
  ],
  "automatedTaxesEnabled": true,
  "customProperties": {},
  "hubspotBillingEnabled": true,
  "id": "<string>",
  "lineItems": [
    {
      "id": "<string>",
      "name": "<string>",
      "pricing": {
        "prices": [
          {
            "currencyCode": "<string>",
            "price": 123,
            "maxQuantity": 123
          }
        ],
        "pricingModel": "FLAT"
      },
      "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,
      "billingStartDelayType": "HS_BILLING_START_DELAY_DAYS",
      "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,
      "isParent": true,
      "lineItemCurrencyCode": "<string>",
      "mrr": 123,
      "parentLineItemId": "<string>",
      "positionOnQuote": 123,
      "postTaxAmount": 123,
      "preDiscountAmount": 123,
      "price": 123,
      "priceBookId": "<string>",
      "pricingModel": "FLAT",
      "productId": "<string>",
      "productType": "<string>",
      "rampKey": "<string>",
      "recurringBillingDayOfMonth": 123,
      "recurringBillingEndDate": "2023-12-25",
      "recurringBillingFrequency": "ANNUALLY",
      "recurringBillingNumberOfPayments": 123,
      "recurringBillingPeriod": "<string>",
      "recurringBillingStartDate": "2023-12-25",
      "recurringBillingTerms": "AUTOMATICALLY_RENEW",
      "richTextDescription": "<string>",
      "sku": "<string>",
      "tax": 123,
      "taxAmount": 123,
      "taxCategory": "<string>",
      "taxRateGroupId": "<string>",
      "tcv": 123,
      "termInMonths": 123,
      "tierAmount": 123,
      "totalDiscount": 123,
      "updatedAt": "2023-11-07T05:31:56Z",
      "variantId": "<string>"
    }
  ],
  "paymentEnabled": true,
  "status": "ACTIVE",
  "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",
  "businessUnitId": "<string>",
  "cardFeeName": "<string>",
  "cardFeePercentage": 123,
  "collectionProcess": "AUTOMATIC_PAYMENTS",
  "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 the external payment method reference ID.

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 for 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 of address types to collect, which can include 'BILLING_ADDRESS' and 'SHIPPING_ADDRESS'.

Available options:

BILLING_ADDRESS,

SHIPPING_ADDRESS

allowedPaymentMethods

enum<string>[]

An array of allowed payment methods for the contract, such as 'CREDIT_OR_DEBIT_CARD', 'ACH', 'SEPA', 'BACS', 'PADS', 'AFFIRM', and 'KLARNA'.

Available options:

CREDIT_OR_DEBIT_CARD,

ACH,

SEPA,

BACS,

PADS,

AFFIRM,

KLARNA

businessUnitId

string

A string representing the ID of the business unit associated with the contract.

collectionProcess

enum<string>

A string indicating the collection process for the contract, which can be 'MANUAL_PAYMENTS' or 'AUTOMATIC_PAYMENTS'.

Available options:

AUTOMATIC_PAYMENTS,

MANUAL_PAYMENTS

customProperties

object

An object containing custom properties for the contract, with string values.

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. Valid values include 'CREDIT_OR_DEBIT_CARD', 'ACH', 'SEPA', 'BACS', 'PADS', 'AFFIRM', and 'KLARNA'.

Available options:

CREDIT_OR_DEBIT_CARD,

ACH,

SEPA,

BACS,

PADS,

AFFIRM,

KLARNA

automatedTaxesEnabled

boolean

required

Indicates whether automated taxes are enabled for the contract.

customProperties

object

required

A map of custom property names to their values.

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 of the fee applied to all transactions.

annualContractValue

number

The annual value of the contract.

billingAddress

object

Show child attributes

billingCompanyId

string

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

billingContactId

string

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

billingStartDateOverride

string<date>

The date to override the billing start date, in ISO 8601 format.

businessUnitId

string

The unique identifier of the business unit associated with the contract.

cardFeeName

string

The name of the fee applied to card transactions.

cardFeePercentage

number

The percentage of the 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 date when the contract becomes effective, in ISO 8601 format.

contractSourceId

string

The unique identifier of 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 associated with the contract, represented as a string.

currentAnnualRecurringRevenue

number

The current annual recurring revenue for the contract.

currentMonthlyRecurringRevenue

number

The current monthly recurring revenue for the contract.

dealId

string

The unique identifier of the deal associated with the contract.

directDebitFeeName

string

The name of the fee applied to direct debit transactions.

directDebitFeePercentage

number

The percentage of the 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 ISO 8601 format.

externalPaymentMethodReferenceId

string

The external reference ID for the payment method.

language

string

The language associated with the contract.

locale

string

The locale associated with 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.

renewalContractId

string

The unique identifier of the renewal contract.

renewalDate

string<date>

The date when the contract is set to renew, in ISO 8601 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 ISO 8601 format.

terminationDate

string<date>

The date when the contract is terminated, in ISO 8601 format.

totalBilledAmount

number

The total amount billed under the contract.

totalBilledAmountPreTax

number

The total amount billed under the contract before tax.

totalCollectedFees

number

The total amount of fees collected under the contract.

totalCollectedTaxes

number

The total amount of taxes collected under the contract.

totalContractValue

number

The total value of the contract.

totalPaidAmount

number

The total amount paid under the contract.

updatedAt

string<date-time>

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

Last modified on September 9, 2026