--- updatedAt: 2026-05-26T17:53:48.000Z agentTools: projectIndex: https://developer.bill.com/v2/llms.txt --- # Bulk delete customer contacts Bulk delete customer contact objects. The maximum number of objects you can set in a bulk operation is 100. In the response, `isActive` is set as `2` (Inactive). ### What is a customer contact? When you create a customer with [`/v2/Crud/Create/Customer.json`](ref:ar-customermgmt-createcustomer), one contact is added. You can create additional customer contacts with [`/v2/Crud/Create/CustomerContact.json`](ref:ar-customermgmt-createcustomercontact). Additional customer contacts are useful when the customer has multiple departments, such as purchasing, sales, and accounting. With multiple customer contacts, you can select one or more contacts for receiving invoices and other communications. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "AR | Customer management", "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" ] }, "paths": { "/Bulk/Crud/Delete/CustomerContact.json": { "post": { "summary": "Bulk delete customer contacts", "operationId": "ar-customermgmt-bulkdeletecustomercontact", "description": "Bulk delete customer contact objects. The maximum number of objects you can set in a bulk operation is 100.\n\nIn the response, `isActive` is set as `2` (Inactive).\n\n### What is a customer contact?\nWhen you create a customer with [`/v2/Crud/Create/Customer.json`](https://developer.bill.com/reference/ar-customermgmt-createcustomer), one contact is added. You can create additional customer contacts with [`/v2/Crud/Create/CustomerContact.json`](https://developer.bill.com/reference/ar-customermgmt-createcustomercontact).\n\nAdditional customer contacts are useful when the customer has multiple departments, such as purchasing, sales, and accounting. With multiple customer contacts, you can select one or more contacts for receiving invoices and other communications.", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkDeleteCustomerContactResponse" } } } } }, "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/BulkDeleteCustomerContactRequest" } } } } } }, "tags": [ "Customer contact" ] }, "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`)" } } }, "CreateCustomerContactResponse": { "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 `CustomerContact`." }, "id": { "type": "string", "description": "BILL-generated ID of the customer contact. The value begins with `cpu`." }, "isActive": { "type": "string", "description": "Object visibility status. Inactive objects are hidden by default in the BILL web app.\n* `1`: Active\n* `2`: Inactive" }, "createdTime": { "type": "string", "description": "Created date and time" }, "updatedTime": { "type": "string", "description": "Updated date and time" }, "customerId": { "type": "string", "description": "BILL-generated ID of the customer. The value begins with `0cu`." }, "firstName": { "type": "string", "description": "Customer contact first name" }, "lastName": { "type": "string", "description": "Customer contact last name" }, "email": { "type": "string", "description": "Customer email address" }, "phone": { "type": "string", "description": "Customer phone number" }, "altPhone": { "type": "string", "description": "Customer alternate phone number" }, "fax": { "type": "string", "description": "Customer fax number" }, "timezoneId": { "type": "string", "description": "Customer contact time zone.\n* `3`: Pacific Time (PT)\n* `4`: Mountain Time (MT)\n* `5`: Central Time (CT)\n* `6`: Eastern Time (ET)" } } } } }, "DeleteCustomerContactRequest": { "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "BILL-generated ID of the customer contact. The value begins with `cpu`." } } }, "BulkDeleteCustomerContactRequest": { "type": "object", "required": [ "bulk" ], "properties": { "bulk": { "type": "array", "items": { "$ref": "#/components/schemas/DeleteCustomerContactRequest" } } } }, "BulkDeleteCustomerContactResponse": { "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": { "bulk": { "type": "array", "items": { "$ref": "#/components/schemas/CreateCustomerContactResponse" } } } } } } } } } ```