Create Vendor Bill | Deel

import requests
url = "https://api.letsdeel.com/rest/v2/accounts-payable/vendor-bills"
payload = { "data": {
        "date": "2025-01-15",
        "amount": 1500,
        "currency": "USD",
        "due_date": "2025-02-15",
        "subtotal": 1500,
        "reference": "BF-2025-001",
        "vendor_id": "123",
        "line_items": [
            {
                "amount": 1500,
                "quantity": 10,
                "vat_rate": 0,
                "unit_price": 150,
                "description": "Legal consultation services"
            }
        ],
        "description": "Legal services for Q1 2025",
        "external_id": "brightflag-invoice-12345",
        "subsidiary_id": "456"
    } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "data": {
    "id": "9b9fc43a-a90c-4615-ac50-baf1e314b53e",
    "date": "2025-01-15",
    "amount": 1500,
    "currency": "USD",
    "due_date": "2025-02-15",
    "subtotal": 1500,
    "is_active": true,
    "reference": "BF-2025-001",
    "vendor_id": "123",
    "created_at": "2025-01-15T10:30:00Z",
    "line_items": [
      {
        "id": "9dd4c31a-7613-477e-bf67-3b56ec8879d9",
        "amount": 1500,
        "quantity": 10,
        "vat_rate": 0,
        "created_at": "2025-01-15T10:30:00Z",
        "unit_price": 150,
        "updated_at": "2025-01-15T10:30:00Z",
        "vat_amount": 0,
        "description": "Legal consultation services",
        "vendor_bill_id": "9b9fc43a-a90c-4615-ac50-baf1e314b53e",
        "vat_code": "S-GB",
        "department_id": "99",
        "expense_account_id": "250"
      }
    ],
    "updated_at": "2025-01-15T10:30:00Z",
    "description": "Legal services for Q1 2025",
    "external_id": "brightflag-invoice-12345",
    "exchange_rate": 1,
    "subsidiary_id": "456"
  }
}

Creates vendor bills from structured invoice data submitted by an external invoice provider integration. Token scopes: treasury-vendorbill:write

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

1 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Request

Create vendor bills from external invoice provider data

dataobjectRequired

Response

Vendor bill created successfully

dataobject

1	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2	-H 'Authorization: Bearer YOUR-TOKEN-HERE'

Authentication

Authentication

Request

Response

Errors

Authentication