Update Customer | Papertracc Docs

curl -X PATCH https://api.papertracc.com/v1/profiles/customers/id \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "display_name": "Johnathan Doe",
  "first_name": "Johnathan",
  "last_name": "Doe",
  "company_name": "Doe Consulting",
  "email": "johnathan@example.com",
  "phone": "+2348098765432",
  "currency_code": "NGN",
  "shipping_address": {
    "city": "Lagos",
    "name": "Home",
    "state": "Lagos",
    "country": "Nigeria",
    "address_one": "14 Marina Road",
    "phone": "+2348098765432",
    "post_code": "100001",
    "country_code": "NG"
  },
  "billing_address": {
    "city": "Lagos",
    "name": "Home",
    "state": "Lagos",
    "country": "Nigeria",
    "address_one": "14 Marina Road",
    "phone": "+2348098765432",
    "post_code": "100001",
    "country_code": "NG"
  }
}'

{
  "data": {
    "id": "7d2c9c72-392c-4f8d-b3f1-c1fef2c2d501",
    "type": "INDIVIDUAL",
    "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": "John Doe",
    "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 customer"
}

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

Requires the can_modify_customer_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 customer. Applied to new invoices that name no term or due date.

clear_payment_termbooleanOptional

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

shipping_addressobjectOptional

billing_addressobjectOptional

Response

dataobject

statusboolean

messagestring

Errors

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error