Create Vendor | Papertracc Docs

curl -X POST https://api.papertracc.com/v1/profiles/vendors \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "type": "BUSINESS",
  "email": "billing@globalsoft.dev",
  "phone": "+2348011112222",
  "company_name": "Global Softworks LLC",
  "display_name": "Global Softworks",
  "currency_code": "NGN",
  "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": "Warehouse",
    "phone": "+2348012345678",
    "state": "Lagos",
    "country": "Nigeria",
    "post_code": "100001",
    "address_one": "18 Warehouse Road",
    "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"
    }
  },
  "status": true,
  "message": "Successfully created vendor"
}

Creates a vendor profile.

Authentication

AuthorizationBearer

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

identitystring

The identity for the active project.

Request

This endpoint expects an object.

typestringRequired

emailstringRequiredformat: "email"

phonestringRequired

company_namestringRequired

display_namestringRequired

currency_codestringRequired

billing_addressobjectRequired

shipping_addressobjectRequired

Response

Created

dataobject

statusboolean

messagestring