--- updatedAt: 2025-10-02T22:25:47.000Z agentTools: projectIndex: https://developer.bill.com/v2/llms.txt --- # Create a payment term Create a new payment term object. In your request, set `netDue` as the number of days that a customer has to pay a bill. When a bill is created and this payment term is applied, BILL automatically populates the invoice due date based on the terms. See the parameters for the complete list of categories. ### What is a payment term? A payment term object is useful for vendor bills and customer invoices. For customers, a payment term object defines when a payment is expected. For vendors, the payment term object defines when the payment is sent. ### Display payment term in the BILL web app You can display payment term numbers with the BILL web app. 1. In the BILL web app, click **SETTINGS** at the top-right. 2. Click **Preferences** under **Accounting**. 3. Click the edit icon at the top-right. 4. Set **Payment Term Preference on Bills** as **Yes** and then click **SAVE**. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Organization | Accounts tracking", "version": "2.0", "description": "BILL is a cloud-based cash flow management system for an organization's Accounts Payable (AP) and Accounts Receivable (AR) automation.\n * **AP**: Automate workflows to pay vendors bills at scale for the goods and services they provide. Pay vendors with a wide range of payment methods. Generate vendor credits, bill credits, and payment disbursement reports.\n * **AR**: Automate workflows to get paid by customers at scale for the goods and services you provide. Generate and send invoices on a schedule, generate customer and invoice credits, and seamlessly charge authorized customers.\n * **Organization**: Manage your bank accounts (for sending and receiving payments), users (with user roles), and sync with your choice of accounting software.\n\nIntegrate with the BILL API to send and receive payments for your business. See [Support Center](https://help.bill.com/hc/en-us) for resources about using the BILL web app.", "contact": { "email": "developerprogram@hq.bill.com" } }, "servers": [ { "url": "https://api-stage.bill.com/api/v2", "description": "Sandbox base URL" } ], "x-readme": { "samples-languages": [ "curl", "java", "javascript", "python", "ruby" ], "explorer-enabled": true, "proxy-enabled": true }, "paths": { "/Crud/Create/PaymentTerm.json": { "post": { "summary": "Create a payment term", "operationId": "org-accounts-createpaymentterm", "description": "Create a new payment term object.\n\nIn your request, set `netDue` as the number of days that a customer has to pay a bill. When a bill is created and this payment term is applied, BILL automatically populates the invoice due date based on the terms. See the parameters for the complete list of categories.\n\n### What is a payment term?\nA payment term object is useful for vendor bills and customer invoices. For customers, a payment term object defines when a payment is expected. For vendors, the payment term object defines when the payment is sent.\n\n### Display payment term in the BILL web app\nYou can display payment term numbers with the BILL web app.\n1. In the BILL web app, click **SETTINGS** at the top-right.\n2. Click **Preferences** under **Accounting**.\n3. Click the edit icon at the top-right.\n4. Set **Payment Term Preference on Bills** as **Yes** and then click **SAVE**.", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePaymentTermResponse" } } } } }, "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "required": [ "devKey", "sessionId", "data" ], "properties": { "devKey": { "type": "string", "description": "Developer key generated with your BILL developer account" }, "sessionId": { "type": "string", "description": "API session ID generated with [`/v2/Login.json`](https://developer.bill.com/reference/auth-login)" }, "data": { "$ref": "#/components/schemas/CreatePaymentTermRequest" } } } } } }, "tags": [ "Payment terms" ] }, "parameters": [] } }, "components": { "schemas": { "ErrorResponse": { "type": "object", "properties": { "error_code": { "type": "string", "description": "Error code (only when `response_status` is `1`)" }, "error_message": { "type": "string", "description": "Error message (only when `response_status` is `1`)" } } }, "CreatePaymentTermRequest": { "type": "object", "required": [ "obj" ], "properties": { "obj": { "type": "object", "required": [ "entity", "name", "netDue" ], "properties": { "entity": { "type": "string", "default": "PaymentTerm", "description": "Object type. Set as `PaymentTerm`." }, "name": { "type": "string", "description": "Payment term name" }, "netDue": { "type": "number", "description": "Number of days that a customer has to pay a bill" } } } } }, "CreatePaymentTermResponse": { "type": "object", "properties": { "response_status": { "type": "integer", "description": "Response status.\n* `0`: Success response\n* `1`: Error response. Only `error_code` and `error_message` is returned in `response_data`." }, "response_message": { "type": "string", "description": "Response status.\n* `Success`: Success response\n* `Error`: Error response. Only `error_code` and `error_message` is returned in `response_data`." }, "response_data": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/ErrorResponse" } ], "properties": { "entity": { "type": "string", "description": "Object type. Set as `PaymentTerm`." }, "id": { "type": "string", "description": "BILL-generated payment term ID. The value begins with `00p`." }, "name": { "type": "string", "description": "Payment term name" }, "netDue": { "type": "number", "description": "Number of days that a customer has to pay a bill" } } } } } } } } ```