Create Vendor credit

Creates a new record.

POSThttps://api.tracksales.co/api/v1/vendor-credits

Required scope: vendor_credits:create

Body Params

vendorIdstringrequired

Vendor UUID

itemsarrayrequired

Line items

Responses

201Created

Request succeeded.

401Unauthorized

API key is missing or invalid.

403Forbidden

API key lacks the required scope.

404Not Found

Vendor-credits was not found.

422Validation Error

Request validation failed.

curl -X POST 'https://api.tracksales.co/api/v1/vendor-credits' \
  -H 'Authorization: Bearer ts_live_YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"vendorId":8,"date":"2026-07-02","items":[{"itemId":101,"quantity":1,"unitPrice":1500}]}'

{
    "success": true,
    "data": {
        "vendor_credit_id": 701,
        "vendorId": 8,
        "total": 1500
    }
}

{
    "success": false,
    "error": {
        "code": "unauthenticated",
        "message": "Invalid or revoked API key."
    }
}

{
    "success": false,
    "error": {
        "code": "forbidden",
        "message": "API key lacks required scope."
    }
}

{
    "success": false,
    "message": "Vendor-credits not found"
}

{
    "success": false,
    "message": "Validation failed",
    "errors": {
        "field": [
            "The field is required."
        ]
    }
}