Set up Ramp it up
Before you start
You need permission to install apps in the HubSpot account and access to deals, products and line items.
Install the app
- Open the install link we sent you.
- Choose the HubSpot account you want to connect.
- Review the requested permissions.
- Approve the connection.
- Return to a HubSpot deal.
Add the cards
HubSpot admins can place both Ramp it up surfaces on the deal record:
- Open a deal.
- Select Customize record.
- Add Ramp it up workspace to the middle column.
- Add Ramp it up to the right sidebar.
- Save the layout for the required teams or pipelines.
The middle card is the primary workspace.
The sidebar card opens the same workflow in a modal.
Configure defaults
Open the app settings in HubSpot to set:
- Default contract term
- Default ramp interval
- Default change method and value
- Default introductory period
- Default line-item naming format
- Whether the deal amount updates after each ramp
Reps can override these defaults for an individual deal.
Create a ramp
- Add the deal's Year 1 products and one-time fees using HubSpot line items.
- Confirm each recurring product has the correct billing frequency and start date.
- Open Ramp it up workspace.
- Review each recurring product and its pricing rule.
- Confirm the contract term and deal currency.
- Review the future periods and contract total.
- Select Ramp it up!.
Ramp it up creates only the future recurring periods.
It keeps one-time fees once and retains the existing Year 1 baseline.
Update an existing ramp
Open the workspace, change the schedule and select Ramp it up! again.
The app replaces its previous future line items instead of appending duplicates.
Manually created line items are preserved.
Remove the app
Use the uninstall control in the app settings.
Ramp it up removes the HubSpot installation and deletes its stored OAuth credentials.
Existing HubSpot line items are not deleted automatically.
Scopes and data disclosure
Requested HubSpot scopes
- oauth
- Connects the HubSpot account and refreshes authorised access.
- crm.objects.deals.read
- Reads the current deal, currency and associated line items.
- crm.objects.deals.write
- Updates deal currency and deal amount when the user requests it.
- crm.objects.line_items.read
- Reads Year 1 line items, billing data, prices, discounts and product links.
- crm.objects.line_items.write
- Creates, updates and removes ramp line items.
- crm.objects.products.read
- Verifies product records and preserves product IDs, SKUs and mapped properties.
- crm.schemas.line_items.read
- Verifies that required commerce properties are available before writing data.
Data read from HubSpot
- HubSpot account ID
- Deal ID, amount, currency and exchange rate
- Line-item names, prices, quantities, amounts and quote positions
- Product IDs and SKUs
- Billing frequencies, billing periods and billing start dates
- Line-item discounts required to reconstruct free introductory periods
- Line-item and product property definitions required for compatibility checks
Data written to HubSpot
- Future ramp line items associated with the selected deal
- Native billing dates, billing periods and discounts
- Deal currency when the user changes it
- Deal amount when the user leaves the default update option enabled
Data stored outside HubSpot
- Encrypted OAuth access and refresh tokens
- HubSpot account ID and OAuth scopes
- Company-level Ramp it up defaults
- IDs of the most recent app-generated ramp line items for safe replacement
- Feedback submitted through the app
Ramp it up does not store contact records, company records, email content, payment card details or quote documents.
Removal
The uninstall endpoint uses HubSpot's
DELETE /appinstalls/v3/external-install
endpoint and removes the locally stored installation credentials after HubSpot confirms the uninstall.