Rippling: PUT Tiered Match 401 K — request body — body

API reference · Contract 2026-10-28

SDK schema: PUT Tiered Match 401 K — request body — body

Field	Type	Presence	Description and constraints
$	object	Root	A 401K Tiered Match object. Defines the employer match scheme for 401K contributions.
ein	string	Optional	If set, this tiered match will only apply to employees in this entity.
employees	array	Optional	The group of specified employees that this tiered match applies to. This field should be used if isDefault is set to false to define the group of employees that the tiered match applies to.
employees[]	string	Each item
employerMatch401K	array	Optional	An employer 401k match object.
employerMatch401K[]	JSON	Each item
employerMatch401K[] (anyOf 1)	object	Alternative
employerMatch401K[] (anyOf 1).eePercentComp	string	Optional	Employee percent
employerMatch401K[] (anyOf 1).erMatchPercent	string	Optional	Employer match percentage
employerMatch401K[] (anyOf 1).tierNum	integer	Optional	Tier number
employerMatch401K[] (anyOf 2)	null	Alternative
id	string	Optional	Unique identifier of the 401K Tiered Match object.
isDefault	boolean	Optional	If set to true, this tiered match will be applied to all employees by default unless its overridden. If set to false, it will only apply to the applicable employees.
matchingScheme401K	string	Required within parent	One of: SAFE_HARBOR_BASIC, SAFE_HARBOR_ENHANCED, CUSTOM