Ramp: Create a spend program — request body — body

API reference · Contract 2026-10-27

SDK schema: Create a spend program — request body — body

Field	Type	Presence	Description and constraints
$	object	Root
description	string	Required within parent	Description of the spend program.
display_name	string	Required within parent	Display name of the spend program.
icon	string	Required within parent	The template icon for the spend program. One of: AccountingServicesIcon, AdvertisingIcon, CONTRACTORS_AND_PROFESSIONAL_SERVICES, CUSTOM, CardIcon, EducationStipendIcon, EmployeeRewardsIcon, GroundTransportationIcon, LegalFeesIcon, LodgingIcon, LunchOrderingIcon, OnboardingIcon, PerDiemCardIcon, SOFTWARE, SaasSubscriptionIcon, SoftwareTrialIcon, SuppliesIcon, TeamSocialIcon, TravelExpensesIcon, VirtualEventIcon, WellnessIcon, WorkFromHomeIcon, advertising, airlines, bills, business, car_services, contractor, education, entertainment, event_balloons, event_virtual, food, fuel_and_gas, general_expense, general_merchandise, gift, government_services, internet_and_phone, legal, lodging, lodging_room, newspaper, office, physical_card, procurement_checklist, procurement_intake, professional_services, restaurants, reward, saas_software, shipping, travel_misc, wellness
is_shareable	boolean	Optional	Dictates whether the spend program is shareable among multiple users. Default: false
issuance_rules	JSON	Optional
issuance_rules (anyOf 1)	Model	Alternative	Expand Create a spend program — request body — body issuance rules automatic, requestable Spend Program Issuance Rules can be set for requests or default issuance of Limits from a program. Set whether a program is requestable or issued by default for a given set of users and their attributes (department, locations, and custom fields). If you’d like to give these permissions to all employees, you can set `applies_to_all` to `True`. Feel free to ignore this if you don’t want any custom requestability or issuance logic. Default: null
issuance_rules (anyOf 2)	null	Alternative
issue_physical_card_if_needed	boolean	Optional	Dictates whether the spend program should issue a physical card if the user does not have one. Default: false
permitted_spend_types	Model	Required within parent	Expand Create a spend program — request body — body permitted spend types Specifies the permitted spend types for the spend program.
spending_restrictions	Model	Required within parent	Expand Create a spend program — request body — body spending restrictions A set of restrictions imposed on the spend program.

Referenced models: Create a spend program — request body — body permitted spend types, Create a spend program — request body — body issuance rules automatic, requestable, Create a spend program — request body — body spending restrictions