Submit Complete Plan Request
This action can be used to create a highly tailored and customized plan request where the entire plan request experience is skipped.
This call has many more required fields than the Start Personal Plan Request action. If you don't want the end-user to go through the plan request but don't have enough information or want to make enough assumptions to provide all required fields for this action, you can use the Start Personal Plan Request action and have someone on your team go through the plan request on the behalf of the end-user.
To access instant quotes from this call, you first need to make sure that your BackNine integration is activated. Secondly, any instant quotes that may be generated from the call will not be returned in the API response. Instead, you will have to set up New Personal Plan Webhooks to receive these quotes asynchronously.
API Method:
Submit Complete Personal Plan Request
POST
https://app.whiteswan.io/api/1.1/wf/complete_request
Submits a complete personal plan request.
Headers
Authorization*
String
Bearer <YOUR API KEY>
Content-Type*
String
application/json
Accept*
String
application/json
user-agent*
String
<YOUR APP>
Request Body
JSON Body*
Object
See specification below
Please note that the sample body payload above contains all possible parameters for your reference. In an actual call, you don't need to use all parameters, and some parameters are only relevant for certain policy types or plan goals.
Code Examples - Making the API Call:
Code examples are available in cURL, Python, Javascript, Java, PHP, Ruby, and Go, but can be constructed for other languages and tools. Some code examples include dependencies that may need to be installed in your codebase to ensure functionality. Please note that the code examples above does not contain all available input fields. Feel free to edit using the specification below. Also remember to replace any values in the code that looks like <VALUE> and to adapt the parameter values passed.
Body Parameters Specification:
Name
name
Text
Yes
John Doe
The full name of the person who the request is made on behalf of.
-
Text
Yes
john@example.com
The email of the person who the request is made on behalf of.
-
Intended Insured Name
intended_insured_name
Text
No
Jack Doe
If the intended insured is not the same person as the policy holder, include the full name of the intended insured.
Second Insured Name
name_2
Text
No
Jane Doe
If covering two people, the full name of the second insured.
Policy type
policy_type
Multiple-Choice
Yes
Term Life
The policy type that this request is made for.
Variable Universal Life, Indexed Universal Life, Whole Life, Term Life, Guaranteed Universal Life, Private Placement Life, Final Expense, Accidental Death, Linked Benefit, Long Term Care
Main Goal
main_goal
Multiple-Choice
Yes
Accumulation
The primary goal of this plan request, either Protection, Balanced, or Accumulation.
Accumulation, Balanced, Protection
Pre-fill Application Data ID
contact_id
Text
No
12345
If you have already created a pre-fill information you can pass its ID by using this parameter to associate that info with this request.
-
Case Associated Person (Email)
associated_person
Text
No
associate@example.com
Optionally this case can be associated with a specific user on your White Swan account by including their email here. If left blank, it will be the person who set up this zap.
-
Phone Number
phone
Text
No
(123) 456-7890
The phone number of the person who the request is made on behalf of.
-
Resident State
resident_state
Multiple-Choice
Yes
California
The state in which the insured person is a resident.
All 50 States in the United States, written out in full in a capitalized form like example value.
Death Benefit Need
death_benefit
Number
Yes
500000
The amount of death benefit that is required for this plan. To opt for the lowest amount possible given a certain premium budget, use 0.
-
Payment Schedule
payment_schedule
Multiple-Choice
Yes
Monthly
How often premiums should be paid on this plan.
Monthly, Quarterly, Yearly
Paid Up Period
paid_up_period
Multiple-Choice
No
10 Years
How many years premiums should be paid on the policy (N/A for term life).
One-time, 10 Years, 20 Years, 30 Years, Lifetime
Term Life Coverage Period
term_duration
Multiple-Choice
No
20 Years
If this request is for term life, how many years the policy should cover the insured.
Less than 10 years, 10 Years, 15 Years, 20 Years, 30 Years, 40 Years
Premium Budget
premium_budget
Number
No
1000
The budget for premium payments (only applicable for plan requests with Accumulation as the main goal).
-
Gender
gender
Multiple-Choice
Yes
Male
Whether the intended insured person is Male or Female.
Male, Female
Second Insured Gender
gender_2
Multiple-Choice
No
Female
If covering two people, whether the second insured is Male or Female.
Male, Female
Date of Birth
date_of_birth
DateTime
Yes
19850716T000000+0100
The date of birth of the intended insured person.
-
Second Insured Date of Birth
date_of_birth_2
DateTime
No
19850716T000000+0100
If covering two people, the date of birth of the second insured.
-
Health Rating
health_rating
Multiple-Choice
Yes
Good
How the insured person would rate their own general health.
Average, Good, Excellent
Second Insured Health Rating
health_rating_2
Multiple-Choice
No
Excellent
If covering two people, how would the second insured rate their general health.
Average, Good, Excellent
Insured Uses Tobacco/Nicotine
tobacco
Boolean
Yes
false
Whether the intended insured person uses tobacco/nicotine products or not.
-
Second Insured Uses Tobacco/Nicotine
tobacco_2
Boolean
No
false
If covering two people, whether the second insured uses tobacco/nicotine products or not.
-
Insured Uses Marijuana/THC
marijuana
Boolean
No
false
Whether the intended insured person uses marijuana/THC products or not.
-
Second Insured Uses Marijuana/THC
marijuana_2
Boolean
No
false
If covering two people, whether the second insured uses marijuana/THC products or not.
-
Insured Height in Feet
height_feet
Number
Yes
6
The height in feet of the intended insured person.
-
Insured Height in Inches
height_inches
Number
Yes
2
The height in inches of the intended insured person.
-
Second Insured Height in Feet
height_feet_2
Number
No
5
If covering two people, the height in feet of the second insured.
-
Second Insured Height in Inches
height_inches_2
Number
No
6
If covering two people, the height in inches of the second insured.
-
Insured Weight in Pounds
weight_pounds
Number
Yes
180
The weight in pounds of the intended insured person.
-
Second Insured Weight in Pounds
weight_pounds_2
Number
No
170
If covering two people, the weight in pounds of the second insured.
-
Risk Profile (Only Variable Universal Life)
risk_profile
Multiple-Choice
No
Moderate
The risk appetite of the intended policy owner. Only applicable for Variable Universal Life.
Conservative, Moderate, Aggressive
Expedited Product Preference
expedited_products
Boolean
No
false
Whether this request should be for a product with expedited underwriting, which are policies that can be issued in 1-2 days.
-
Convertability Preference (Term life only)
convertability
Boolean
No
false
Whether a term life insurance should have the option to be converted into a permanent life insurance policy.
-
Riders for the Plan
riders
Text
No
Paid Up Additions (Whole Life Only)
The riders that should be included in this plan.
Paid Up Additions (Whole Life Only), Guaranteed Insurability Rider, Waiver of Premium Rider, Terminal Illness Rider, Return of Premium Rider, Child Insurance Rider, Supplemental Term Rider, Charitable Benefit Rider, Overloan Protection Rider, No Lapse Guarantee Rider, Enhanced Cash Surrender Value Rider, Conversion Extension (Term Life Only), Chronic/Critical Illness Rider, Waiver of Premium Rider, Return of Premium Rider
Supplemental Term Coverage Length
supplemental_term_length
Multiple-Choice
No
10 Years
If Supplemental term is included as a rider, this value refers to the number of years that the supplemental term rider will cover the insured.
10 Years, 20 Years, 30 Years, Life
Supplemental Term Amount
supplemental_term_amount
Number
No
100000
If Supplemental term is included as a rider, this value refers to the amount of death benefit on the supplemental term rider.
-
Room for additional premium
additional_premium_room
Number
No
5000
The amount of additional future premium that should be able to be paid for this plan while maintaining tax advantages.
-
One-Time Deposit Amount
one_time_deposit_amount
Number
No
10000
The additional (if any) one-time amount that is planned to be deposited with the first premium of this policy.
-
Uncapped Account Preference (Only Indexed Universal Life)
uncapped_accounts
Boolean
No
false
Whether requests for indexed universal life should include accounts without caps (ceiling on yearly crediting rate).
-
Fee Account Preference (Only Indexed Universal Life)
fee_accounts
Boolean
No
false
Whether requests for indexed universal life should include accounts with fees, which may come with additional benefits.
-
Planned Retirement Income
planned_retirement_income
Boolean
No
false
Whether the intended owner of this policy plans to use the policy to access retirement income.
-
Starting Age of Retirement Income
retirement_start_age
Number
No
65
The age the intended owner intends to start distributing retirement income from this policy.
-
Years of Retirement Income
retirement_length
Number
No
20
The amount of years the intended owner intends to distribute retirement income from this policy.
-
Custom Allocation Mix
custom_account_allocation
Boolean
No
false
With this option selected as true, you can customize the recommended account allocations. If it is set to false, White Swan will recommend an appropriate allocation mix for this case.
-
Cash Value Allocations
allocation_accounts
Object List
No
-
For Indexed Universal Life/Variable Universal Life, the accounts to which the cash value of this plan should initially be allocated to.
-Account Type
account_type
Multiple-Choice
No
Fixed Interest Account
The type of account/fund for this allocation slot. Note that account availability varies.
Fixed Interest Account, Domestic Indexed Accounts (Indexed Universal Life Only), International Indexed Accounts (Indexed Universal Life Only), Multi Indexed Accounts (Indexed Universal Life Only), Managed Volatility Accounts (Indexed Universal Life Only), Overall Index Funds (Variable Universal Life Only), Overall Specialty Funds (Variable Universal Life Only), Overall Bond Funds (Variable Universal Life Only), Overall Downside Protected Accounts (Variable Universal Life Only), S&P 500 Index Fund (Variable Universal Life Only), International Markets Funds (Variable Universal Life Only), Emerging Markets Funds (Variable Universal Life Only), Technology & Innovation Funds (Variable Universal Life Only), Real Estate Funds (Variable Universal Life Only), Healthcare Funds (Variable Universal Life Only), Energy Funds (Variable Universal Life Only), Utilities Funds (Variable Universal Life Only), Long Term Bond Funds (Variable Universal Life Only), High Yield Bond Funds (Variable Universal Life Only), Inflation Protected Bond Funds (Variable Universal Life Only), Index-linked Accounts (Variable Universal Life Only)
-Allocation Percentage
allocation_percentage
Number
No
0.5
If custom allocation is selected, the percentage allocated to each account/fund. Note that for variable universal life, percentage allocations for all non Overall Allocation options indicate the allocation as a percentage of the allocation to that Overall category.
-
White Swan Follow Up
ws_follow_up
Boolean
No
true
If this is set to true, White Swan will follow up with this client after the personal plan has been sent.
-
Who Receives Communications for Case
coms_recipients
Multiple-Choice
No
Client & Me
This input could be used to control who receives communications related to this case. If left empty, both you and the client will receive communications.
Client & Me, Only Client, Only Me
Plan Comment
request_comment
Text
No
I might want my wife covered under this plan too - let's discuss
This can be used to leave an optional comment for this case.
-
When using the input to customize cash value allocations for variable universal life, bear in mind that percentages are defined on two levels - overall category allocation, and specific category component allocation. As an example for this, a 50% allocation to Overall Index Funds and a 50% allocation to S&P 500 Index Funds would result in an actual allocation of 25% to S&P 500 Index Funds.
Returned Parameters Specification:
URL to View Request Internally
url_to_view_request
Text
https://app.whiteswan.io/partner_case/1813426016
Internal URL to view the request.
Plan Request Unique ID
request_id
Text
18134212x19601659
Unique ID for the plan request.
Last updated