Create a group scheme member Run in API Explorer
Body
-
The client account that will be the member on the group scheme. Must already be a staff member on the business client that the plan belongs to.
-
Plan status for the member.
Value Description active Active inactive Inactive proposed Proposed Values are
active,inactive, orproposed. -
Optional inactive status when the status is inactive.
Value Description accepted Accepted agency_transferred Agency Transferred cancelled Cancelled claimed Claimed complete Complete death_event Death Event deferred Deferred drawdown Drawdown expired Expired full_drawdown Full Drawdown issued Issued lapsed Lapsed matured Matured not_proceeded_with Not Proceeded With not_taken_up Not Taken Up offered Offered paid_up Paid Up partial_drawdown Partial Drawdown partial_surrender Partial Surrender proposed Proposed prospect Prospect refunded Refunded refused Refused surrendered Surrendered transfer Transfer transferred Transferred underwriting Underwriting vested Vested declined Declined encashment Encashment left_service Left Service premium_holiday Premium Holiday other Other Values are
accepted,agency_transferred,cancelled,claimed,complete,death_event,deferred,drawdown,expired,full_drawdown,issued,lapsed,matured,not_proceeded_with,not_taken_up,offered,paid_up,partial_drawdown,partial_surrender,proposed,prospect,refunded,refused,surrendered,transfer,transferred,underwriting,vested,declined,encashment,left_service,premium_holiday, orother. -
Optional policy number if the group scheme has separate policy numbers per member.
Maximum length is
255. -
Date when the policy went "on risk".
-
Date when the policy was made inactive.
-
Optional "pensionable" salary used for group scheme pensions. Value must be in pennies for example £70,000 is 7000000
-
Optional workplace location for the group scheme member.
-
Optional employment division for the group scheme member.
Responses
-
Hide response attributes Show response attributes object
-
Hide main_account attributes Show main_account attributes object
-
Hide sub_accounts attributes Show sub_accounts attributes object
-
Hide covers attributes Show covers attributes object
-
Hide benefit_amount attributes Show benefit_amount attributes object
-
Hide excess attributes Show excess attributes object
-
Hide claims attributes Show claims attributes object
-
Hide claim_amount attributes Show claim_amount attributes object
-
Hide total_benefit_amount attributes Show total_benefit_amount attributes object
-
Hide total_benefits attributes Show total_benefits attributes object
-
Hide critical_illness attributes Show critical_illness attributes object
-
Hide family_income_benefit attributes Show family_income_benefit attributes object
-
-
Hide latest_valuations attributes Show latest_valuations attributes object
-
Hide value attributes Show value attributes object
-
Hide value attributes Show value attributes object
-
Hide client attributes Show client attributes object
-
Hide accounts attributes Show accounts attributes object
-
Hide seller attributes Show seller attributes object
-
Hide linked_owners attributes Show linked_owners attributes object
-
Hide linked_plans attributes Show linked_plans attributes object
-
Hide total_benefit_amount attributes Show total_benefit_amount attributes object
-
Hide total_benefits attributes Show total_benefits attributes object
-
Hide critical_illness attributes Show critical_illness attributes object
-
Hide family_income_benefit attributes Show family_income_benefit attributes object
-
-
Hide value attributes Show value attributes object
-
Hide cases attributes Show cases attributes object
-
Hide value attributes Show value attributes object
-
Hide wrap attributes Show wrap attributes object
-
Hide total_benefit_amount attributes Show total_benefit_amount attributes object
-
Hide total_benefits attributes Show total_benefits attributes object
-
Hide critical_illness attributes Show critical_illness attributes object
-
Hide family_income_benefit attributes Show family_income_benefit attributes object
-
-
Hide value attributes Show value attributes object
-
Hide wrap_children attributes Show wrap_children attributes object
-
Hide total_benefit_amount attributes Show total_benefit_amount attributes object
-
Hide total_benefits attributes Show total_benefits attributes object
-
Hide critical_illness attributes Show critical_illness attributes object
-
Hide family_income_benefit attributes Show family_income_benefit attributes object
-
-
Hide value attributes Show value attributes object
-
Hide contract_enquiry_account attributes Show contract_enquiry_account attributes object
-
Hide group_scheme attributes Show group_scheme attributes object
-
Hide total_benefit_amount attributes Show total_benefit_amount attributes object
-
Hide total_benefits attributes Show total_benefits attributes object
-
Hide critical_illness attributes Show critical_illness attributes object
-
Hide family_income_benefit attributes Show family_income_benefit attributes object
-
-
Hide value attributes Show value attributes object
curl \
--request POST 'https://api.plannrcrm.com/api/v1/plans/6ff8f7f6-1eb3-3525-be4a-3932c805afed/group-scheme-members' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
--data '{"account_uuid":"8313824e-c785-449b-b928-f9399d72bc72","status":"active","inactive_status":"accepted","policy_number":"AVIVA-123","on_risk_at":"2023-03-26","inactive_at":"2024-03-26","pensionable_salary":7000000,"workplace_location":"London","employment_division":"Management"}'
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}
# Payload
{
"account_uuid": "8313824e-c785-449b-b928-f9399d72bc72",
"status": "active",
"inactive_status": "accepted",
"policy_number": "AVIVA-123",
"on_risk_at": "2023-03-26",
"inactive_at": "2024-03-26",
"pensionable_salary": 7000000,
"workplace_location": "London",
"employment_division": "Management"
}
{
"amount": {
"example": "4000",
"description": "Money amount at their lowest denominator (for example: pennies)"
},
"currency": {
"example": "GBP",
"description": "Currency of the money"
},
"formatted": {
"example": "£40.00",
"description": "Money amount formatted with currency"
}
}