Ramp

Overview

Connect your users to Ramp for corporate card management, expense tracking, transaction data, and spend analytics.

Property	Value
Provider ID	ramp
Category	Finance
PKCE	Supported
Token refresh	Automatic
Redirect URI	Shown in Developer Portal

Step 1: Create a Ramp OAuth App

Open the Ramp dashboard

Sign in to the Ramp Dashboard, then go to Company > Developer. Review the Ramp API documentation for OAuth requirements.

Contact Ramp to register the application

Ramp’s OAuth integration requires registration. Follow the instructions in the Ramp API documentation to request API access and register the application.

Configure the redirect URI

Add the Alter callback URL from the Developer Portal to the application’s redirect URI configuration.

Get credentials

Copy the Client ID and Client Secret provided during registration.

Warning

Never share your Client Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Ramp provider

Go to OAuth Providers > Add Provider > Ramp.

Enter credentials

• Client ID: Paste your Ramp Client ID
• Client Secret: Paste your Ramp Client Secret

Select scopes

Choose the scopes the application needs.

Save

Click Save. The provider is now active.

Available Scopes

Scope	Description
transactions:read	Read transaction records
transactions:write	Create and update transactions
users:read	Read user records
cards:read	Read card records
reimbursements:read	Read reimbursement records

Notes

• See the Ramp API authorization documentation for more details.

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
get_transactions_canonical_list_with_pagination	read	GET	/developer/v1/transactions
get_transaction_canonical_resource	read	GET	/developer/v1/transactions/{transaction_id}
patch_transaction_canonical_update_resource	write	PATCH	/developer/v1/transactions/{transaction_id}
get_bill_list_with_pagination	read	GET	/developer/v1/bills
get_bill_resource	read	GET	/developer/v1/bills/{bill_id}
post_bill_list_with_pagination	payment, write	POST	/developer/v1/bills
patch_bill_resource	payment, write	PATCH	/developer/v1/bills/{bill_id}
delete_bill_resource	delete	DELETE	/developer/v1/bills/{bill_id}
get_draft_bill_list_with_pagination	read	GET	/developer/v1/bills/drafts
get_draft_bill_resource	read	GET	/developer/v1/bills/drafts/{draft_bill_id}
post_draft_bill_list_with_pagination	write	POST	/developer/v1/bills/drafts
patch_draft_bill_resource	write	PATCH	/developer/v1/bills/drafts/{draft_bill_id}
get_physical_card_list_with_pagination	read	GET	/developer/v1/cards/physical
get_physical_card_resource	read	GET	/developer/v1/cards/physical/{card_id}
post_physical_card_list_with_pagination	write	POST	/developer/v1/cards/physical
patch_physical_card_resource	write	PATCH	/developer/v1/cards/physical/{card_id}
delete_card_termination_resource	delete	DELETE	/developer/v1/cards/physical/{card_id}
post_card_suspension_resource	write	POST	/developer/v1/cards/physical/{card_id}/suspension
delete_card_unsuspension_resource	write	DELETE	/developer/v1/cards/physical/{card_id}/suspension
get_reimbursement_list_with_pagination	read	GET	/developer/v1/reimbursements
get_reimbursement_resource	read	GET	/developer/v1/reimbursements/{reimbursement_id}
post_mileage_reimbursement_resource	payment, write	POST	/developer/v1/reimbursements/mileage
get_transfer_list_with_pagination	read	GET	/developer/v1/transfers
get_transfer_resource	read	GET	/developer/v1/transfers/{transfer_id}
get_user_list_with_pagination	read	GET	/developer/v1/users
get_user_resource	read	GET	/developer/v1/users/{user_id}
post_user_creation_deferred_task	admin	POST	/developer/v1/users/deferred
patch_user_resource	admin	PATCH	/developer/v1/users/{user_id}
patch_user_deactivation_resource	admin	PATCH	/developer/v1/users/{user_id}/deactivate
post_outbound_webhook_subscription_resource	admin	POST	/developer/v1/webhooks