PortfolioLinkApi

<back to all web services

CreateOrUpdateClient

Requires Authentication
The following routes are available for this service:
All Verbs/clients/create
CreateOrUpdateClient Parameters:
NameParameterData TypeRequiredDescription
ClientViewqueryClientViewNo
ClientView Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
UserIdformstringNo
PartnerIdformintNo
PrimaryEmailformstringNo
SecondaryEmailformstringNo
FirstNameformstringNo
MiddleNamesformstringNo
LastNameformstringNo
FullNameformstringNo
AliasformstringNo
PhoneformstringNo
MobileformstringNo
IdNumberformstringNo
StatusformstringNo
ClientTypeformstringNo
BirthdaySkformstringNo
BirthdayformDateTimeNo
CreatedAsAtformDateTimeNo
UpdatedAsAtformDateTimeNo
GoalsformList<ClientGoalsView>No
ClientGoalsView Parameters:
NameParameterData TypeRequiredDescription
UserIdformstringNo
PortfolioIdformintNo
ClientIdformintNo
ClientFullNameformstringNo
ClientIdNumberformstringNo
ClientPrimaryEmailformstringNo
ClientMobileformstringNo
ClientGoalIdformintNo
ClientGoalResultsIdformintNo
GoalNameformstringNo
PortfolioNameformstringNo
StatusformstringNo
InputLifeExpectancyAgeformintNo
InputCurrentSavingsDateformstringNo
InputCurrentSavingsformdoubleNo
InputExpectedInflationRateformdoubleNo
InputWithdrawalAmountformdoubleNo
InputWithdrawalGrowthRateformdoubleNo
CashReserveformdoubleNo
AdditionalSaPropertyformdoubleNo
ResultsformObjectNo
PartnerSettingsformPartnerSettingsNo
PartnerSettings Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
NameformstringNo
PartnerIdformintNo
PartnerLogoUrlformstringNo
PartnerBackgroundTypeformstringNo
PartnerBackgroundUrlformstringNo
ExpectedInflationRateformdecimalNo
WithdrawalIncomeGrowthRateformdecimalNo
HellosignapikeyformstringNo
EnableCashReserveformboolNo
EnablePropertyformboolNo
PartnerDefaultSettingsformPartnerDefaultSettingsNo
PartnerContactDetailsformPartnerContactDetailsNo
PartnerDefaultSettings Parameters:
NameParameterData TypeRequiredDescription
SettingsIdformintNo
PartnerIdformintNo
PartnerNameformstringNo
AaTypeformstringNo
ThemeIdformintNo
InitialFeeformdecimalNo
AdvisorFeeformdecimalNo
PlatformFeeformdecimalNo
MoreLikelyZScoreformdecimalNo
LessLikelyZScoreformdecimalNo
ShowLowestProjectedOutcomeformboolNo
IsFundAlphaEqualToFeesformboolNo
ShowAdvisoryFeesformboolNo
ShowCashflowTableformboolNo
XAxisLabelformstringNo
AppearanceSettingsformAppearanceSettingsNo
AppearanceSettings Parameters:
NameParameterData TypeRequiredDescription
AppearanceSchemaformAppearanceSchemaNo
ProjectedComponentNameformstringNo
ShowMedianOutcomeformboolNo
MedianLineColorformstringNo
BottomScenarioLineColorformstringNo
ShowLowestProjectedOutcomeformboolNo
AppearanceSchema Parameters:
NameParameterData TypeRequiredDescription
FontColorformstringNo
AxisColorformstringNo
AxisGridColorformstringNo
GraphColorformstringNo
GraphColorOpacityformdoubleNo
GraphColorRange2formstringNo
GraphColorOpacity2formdoubleNo
AverageLineColorformstringNo
BarColor1formstringNo
BarColor2formstringNo
LogoHeightformstringNo
LogoUrlformstringNo
LogoBackgroundformstringNo
TopBarBackgroundformstringNo
TopBarFontColorformstringNo
H2ColorformstringNo
LinkColorformstringNo
ProposalBackgroundUrlformstringNo
ProposalBackgroundUrl2formstringNo
ProposalBackgroundUrl3formstringNo
ProposalBackgroundUrl4formstringNo
PartnerContactDetails Parameters:
NameParameterData TypeRequiredDescription
WebsiteformstringNo
EmailformstringNo
TelephoneformstringNo
FaxformstringNo
AddressLine1formstringNo
AddressLine2formstringNo
AddressLine3formstringNo
AddressLine4formstringNo
CreateOrUpdateClientResponse Parameters:
NameParameterData TypeRequiredDescription
ResultformboolNo
IdformintNo
MessageformstringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv

HTTP + CSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /clients/create HTTP/1.1 
Host: api.portfoliolink.co.za 
Accept: text/csv
Content-Type: text/csv
Content-Length: length

{"clientView":{"id":0,"userId":"String","partnerId":0,"primaryEmail":"String","secondaryEmail":"String","firstName":"String","middleNames":"String","lastName":"String","fullName":"String","alias":"String","phone":"String","mobile":"String","idNumber":"String","status":"String","clientType":"String","birthdaySk":"String","birthday":"0001-01-01T00:00:00.0000000","createdAsAt":"0001-01-01T00:00:00.0000000","updatedAsAt":"0001-01-01T00:00:00.0000000","goals":[{"userId":"String","portfolioId":0,"clientId":0,"clientFullName":"String","clientIdNumber":"String","clientPrimaryEmail":"String","clientMobile":"String","clientGoalId":0,"clientGoalResultsId":0,"goalName":"String","portfolioName":"String","status":"String","inputLifeExpectancyAge":0,"inputCurrentSavingsDate":"String","inputCurrentSavings":0,"inputExpectedInflationRate":0,"inputWithdrawalAmount":0,"inputWithdrawalGrowthRate":0,"cashReserve":0,"additionalSaProperty":0,"results":{},"partnerSettings":{"id":0,"name":"String","partnerId":0,"partnerLogoUrl":"String","partnerBackgroundType":"String","partnerBackgroundUrl":"String","expectedInflationRate":0,"withdrawalIncomeGrowthRate":0,"hellosignapikey":"String","enableCashReserve":false,"enableProperty":false,"partnerDefaultSettings":{"settingsId":0,"partnerId":0,"partnerName":"String","aaType":"String","themeId":0,"initialFee":0,"advisorFee":0,"platformFee":0,"moreLikelyZScore":0,"lessLikelyZScore":0,"showLowestProjectedOutcome":false,"isFundAlphaEqualToFees":false,"showAdvisoryFees":false,"showCashflowTable":false,"xAxisLabel":"String","appearanceSettings":{"appearanceSchema":{"fontColor":"String","axisColor":"String","axisGridColor":"String","graphColor":"String","graphColorOpacity":0,"graphColorRange2":"String","graphColorOpacity2":0,"averageLineColor":"String","barColor1":"String","barColor2":"String","logoHeight":"String","logoUrl":"String","logoBackground":"String","topBarBackground":"String","topBarFontColor":"String","h2Color":"String","linkColor":"String","proposalBackgroundUrl":"String","proposalBackgroundUrl2":"String","proposalBackgroundUrl3":"String","proposalBackgroundUrl4":"String"},"projectedComponentName":"String","showMedianOutcome":false,"medianLineColor":"String","bottomScenarioLineColor":"String","showLowestProjectedOutcome":false}},"partnerContactDetails":{"website":"String","email":"String","telephone":"String","fax":"String","addressLine1":"String","addressLine2":"String","addressLine3":"String","addressLine4":"String"}}}]}}
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length

{"result":false,"id":0,"message":"String"}