Update Vendor | Papertracc Docs

curl -X PATCH https://api.papertracc.com/v1/profiles/vendors/id \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "display_name": "Global Softworks",
  "first_name": "Amaka",
  "last_name": "Okafor",
  "company_name": "Global Softworks LLC",
  "email": "support@globalsoft.dev",
  "phone": "+2348011112222",
  "currency_code": "NGN",
  "shipping_address": {
    "city": "Lagos",
    "name": "Warehouse",
    "state": "Lagos",
    "country": "Nigeria",
    "address_one": "18 Warehouse Road",
    "phone": "+2348012345678",
    "post_code": "100001",
    "country_code": "NG"
  },
  "billing_address": {
    "city": "Lagos",
    "name": "Office",
    "state": "Lagos",
    "country": "Nigeria",
    "address_one": "12 Marina Road",
    "phone": "+2348012345678",
    "post_code": "100001",
    "country_code": "NG"
  }
}'

{
  "data": {
    "id": "0cb2d1a5-2f50-43a1-8c3f-df06f998ef51",
    "type": "BUSINESS",
    "email": "john@example.com",
    "phone": "+2348012345678",
    "accounts": [
      {
        "bank": "Spruce Bank",
        "code": "044",
        "vat_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
        "is_default": true,
        "account_name": "John Doe",
        "currency_code": "NGN",
        "account_number": "1234567890"
      }
    ],
    "last_name": "Doe",
    "contact_id": "64595845-34ec-482c-b0fe-ae617a0f8335",
    "created_at": "2026-06-18T10:00:00Z",
    "first_name": "John",
    "project_id": "spruce-demo",
    "company_name": "Acme Corp",
    "display_name": "Global Softworks",
    "billing_address": {
      "city": "Lagos",
      "name": "Office",
      "phone": "+2348012345678",
      "state": "Lagos",
      "country": "Nigeria",
      "post_code": "100001",
      "address_one": "12 Marina Road",
      "country_code": "NG"
    },
    "shipping_address": {
      "city": "Lagos",
      "name": "Office",
      "phone": "+2348012345678",
      "state": "Lagos",
      "country": "Nigeria",
      "post_code": "100001",
      "address_one": "12 Marina Road",
      "country_code": "NG"
    },
    "payment_term_id": null
  },
  "status": true,
  "message": "Successfully updated vendor"
}

Updates vendor profile fields. payment_term_id changes the vendor’s default payment term and clear_payment_term removes it.

Requires the can_modify_vendor_profile permission on the key owner’s role.

Keys: secret key only.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

identitystring

The identity for the active workspace.

Path parameters

idstringRequired

Request

This endpoint expects an object.

display_namestringOptional

first_namestringOptional

last_namestringOptional

company_namestringOptional

emailstringOptionalformat: "email"

phonestringOptional

currency_codestringOptional

payment_term_idstringOptionalformat: "uuid"

Default payment term for this vendor. Applied to new bills that name no term or due date.

clear_payment_termbooleanOptional

Send true to remove the vendor's default payment term.

shipping_addressobjectOptional

billing_addressobjectOptional

Response

dataobject

statusboolean

messagestring

Errors

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error