# Fiche connecteur Ramp Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno. Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur. ## Ramp URL : https://get-bruno.com/features/connectors/ramp Référence texte : https://get-bruno.com/features/connectors/ramp/reference.txt Origine : Catalogue Pipedream Statut : Catalogue Pipedream — connexion à vérifier Catégories : Gestion d’entreprise Description : Ramp est un service de gestion des dépenses d’entreprise qui expose des actions pour créer et mettre à jour des départements, des sites, des utilisateurs, des limites, des cartes virtuelles et des justificatifs, ainsi que pour consulter des utilisateurs, des limites, des transactions, des transferts et des programmes de dépenses. Authentification : OAuth Présentation : Ramp est un service de gestion des dépenses d’entreprise qui expose des actions pour créer et mettre à jour des départements, des sites, des utilisateurs, des limites, des cartes virtuelles et des justificatifs, ainsi que pour consulter des utilisateurs, des limites, des transactions, des transferts et des programmes de dépenses. Usage : Consulter un utilisateur puis préparer sa mise à jour Exemple de demande : Je veux retrouver l’utilisateur Malik Bernard dans Ramp et préparer son changement de département vers Marketing. Résultat attendu : L’utilisateur est repéré via la liste des utilisateurs, puis sa fiche peut être mise à jour avec l’identifiant du département cible. À préciser : Identifiant de l’utilisateur obtenu via List Users ; Identifiant du département Marketing obtenu via List Departments Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/ramp/actions/list-users ; https://pipedream.com/apps/ramp/actions/list-departments ; https://pipedream.com/apps/ramp/actions/update-user Usage : Émettre une carte virtuelle avec une limite mensuelle Exemple de demande : Je veux émettre une carte virtuelle de 500 dollars par mois pour un utilisateur déjà identifié dans Ramp. Résultat attendu : Une carte virtuelle est émise pour cet utilisateur avec une limite mensuelle de 500 dollars. À préciser : Identifiant de l’utilisateur ; Montant de la limite, par exemple 500 dollars ; Intervalle, par exemple MONTHLY Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/ramp/actions/issue-virtual-card ; https://pipedream.com/apps/ramp/actions/list-users Usage : Retrouver une transaction puis lire son détail Exemple de demande : Je veux vérifier une transaction déjà repérée dans Ramp, par exemple celle associée à Facebook Ads, et récupérer son détail comptable. Résultat attendu : La transaction est récupérée par son identifiant, puis renvoie les champs détaillés disponibles, dont le commerçant, le montant, les lignes et le détail comptable. À préciser : Identifiant de transaction obtenu via List Transactions Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/ramp/actions/list-transactions ; https://pipedream.com/apps/ramp/actions/get-transaction Limites propres au service : Plusieurs listes sont paginées et peuvent nécessiter une page suivante. Une mise à jour d’utilisateur ou de limite exige un identifiant déjà connu. La terminaison d’une limite est définitive et prend effet immédiatement. Un justificatif s’attache à une transaction donnée et à un utilisateur donné. Vocabulaire français : Créer un département — Crée un nouveau département Ramp pour organiser les utilisateurs. (https://pipedream.com/apps/ramp/actions/create-department) Vocabulaire français : Créer un site — Crée un lieu Ramp, par exemple un siège, avant d'y associer des utilisateurs. (https://pipedream.com/apps/ramp/actions/create-location) Vocabulaire français : Inviter un utilisateur — Invite une nouvelle personne par e-mail dans l'organisation Ramp. (https://pipedream.com/apps/ramp/actions/create-user-invite) Vocabulaire français : Obtenir une limite — Récupère une limite de dépense Ramp à partir de son identifiant. (https://pipedream.com/apps/ramp/actions/get-limit) Vocabulaire français : Obtenir une transaction — Récupère une transaction Ramp à partir de son identifiant. (https://pipedream.com/apps/ramp/actions/get-transaction) Vocabulaire français : Obtenir un utilisateur — Récupère un utilisateur Ramp à partir de son identifiant. (https://pipedream.com/apps/ramp/actions/get-user) Vocabulaire français : Émettre une carte virtuelle — Crée une carte virtuelle Ramp pour un utilisateur avec une limite ou un programme de dépenses. (https://pipedream.com/apps/ramp/actions/issue-virtual-card) Vocabulaire français : Lister les départements — Récupère la liste des départements Ramp. (https://pipedream.com/apps/ramp/actions/list-departments) Vocabulaire français : Lister les limites — Récupère la liste paginée des limites de dépenses Ramp. (https://pipedream.com/apps/ramp/actions/list-limits) Vocabulaire français : Lister les sites — Récupère la liste des lieux Ramp. (https://pipedream.com/apps/ramp/actions/list-locations) Vocabulaire français : Lister les programmes de dépenses — Récupère la liste des programmes de dépenses Ramp. (https://pipedream.com/apps/ramp/actions/list-spend-programs) Vocabulaire français : Lister les transactions — Récupère la liste paginée des transactions Ramp. (https://pipedream.com/apps/ramp/actions/list-transactions) Vocabulaire français : Lister les transferts — Récupère la liste des transferts Ramp, avec filtre possible par statut. (https://pipedream.com/apps/ramp/actions/list-transfers) Vocabulaire français : Lister les utilisateurs — Récupère la liste paginée des utilisateurs Ramp. (https://pipedream.com/apps/ramp/actions/list-users) Vocabulaire français : Terminer une limite — Termine définitivement une limite de dépense Ramp. (https://pipedream.com/apps/ramp/actions/terminate-limit) Vocabulaire français : Mettre à jour une limite — Met à jour le nom ou la restriction d'une limite de dépense Ramp. (https://pipedream.com/apps/ramp/actions/update-limit) Vocabulaire français : Mettre à jour un utilisateur — Met à jour un utilisateur Ramp, par exemple son rôle, son département ou son site. (https://pipedream.com/apps/ramp/actions/update-user) Vocabulaire français : Téléverser un justificatif — Téléverse un justificatif pour une transaction et un utilisateur donnés. (https://pipedream.com/apps/ramp/actions/upload-receipt) Vocabulaire français : Nouvelle transaction créée — Déclenche un événement pour chaque nouvelle transaction créée dans Ramp. (https://pipedream.com/apps/ramp/triggers/new-transaction-created) Vocabulaire français : Statut de transaction mis à jour — Déclenche un événement quand le statut d'une transaction change. (https://pipedream.com/apps/ramp/triggers/transaction-status-updated) Vocabulaire français : Statut du paiement de transfert mis à jour — Déclenche un événement quand le statut d'un paiement de transfert change. (https://pipedream.com/apps/ramp/triggers/transfer-payment-updated) - action : Create Department — Create a new Ramp department (e.g. Engineering , Marketing ). Use this to add an organizational unit before assigning users to it. Returns the new department's id , which you can pass to Update User to set a user's department, or use to filter List Transactions / List Users . See the documentation (https://pipedream.com/apps/ramp/actions/create-department) - action : Create Location — Create a new Ramp location (e.g. New York HQ ). Use this to add a site before assigning users to it; the returned id can be passed to Update User or used to filter List Transactions / List Users . Associating an entity is optional — set the Entity ID only for multi-entity businesses that scope locations to a specific legal entity. See the documentation (https://pipedream.com/apps/ramp/actions/create-location) - action : Create User Invite — Invite a new person to your Ramp organization by email — use this to onboard an employee who doesn't yet have a Ramp account. Requires their email, first and last name, and role (e.g. BUSINESS_USER ); department, location, and direct manager are optional. Run List Departments and List Locations to find valid department/location IDs, and List Users to find a direct manager's user ID — each is a Ramp UUID, e.g. fffe6c22-698f-4dc5-b2b1-b35f86947d90 . This is a deferred operation, so the invited user may not appear in List Users immediately; once they do, use Update User to change their role, department, location, or manager. See the documentation (https://pipedream.com/apps/ramp/actions/create-user-invite) - action : Get Limit — Retrieve a single Ramp spend limit by ID. Run the List Limits action first to find a valid limit ID. Example: given a limit id from List Limits , returns the limit's display name, state (e.g. ACTIVE ), balance, spend program, and spending restrictions. See the documentation (https://pipedream.com/apps/ramp/actions/get-limit) - action : Get Transaction — Retrieve a single Ramp transaction by ID. Run the List Transactions action first to find a valid transaction ID. Example: given a transaction id from List Transactions , returns the full transaction — e.g. merchant Facebook Ads , amount $135.00 , category Advertising , plus line items and accounting detail. See the documentation (https://pipedream.com/apps/ramp/actions/get-transaction) - action : Get User — Retrieve a single Ramp user by ID. Run the List Users action first to find a valid user ID. Example: given a user id from List Users , returns that user's full record — name, email, role (e.g. BUSINESS_OWNER ), department id, and location id. See the documentation (https://pipedream.com/apps/ramp/actions/get-user) - action : Issue Virtual Card — Issue a new Ramp virtual card (spend limit) for a user. Run List Users to find the user ID. Works two ways: (1) link to an existing spend program — set Link to Existing Spend Program on and pass a Spend Program ID (run List Spend Programs ), and the program governs the card's restrictions; or (2) set a custom limit — leave linking off and pass a Total Limit per Interval (e.g. $500 ) and an Interval (e.g. MONTHLY ), optionally a per-transaction cap and allowed/blocked categories. Example: issue a $500/month card by passing the user's ID, $500 , and MONTHLY . See the documentation (https://pipedream.com/apps/ramp/actions/issue-virtual-card) - action : List Departments — Retrieve a list of Ramp departments. Use this to find department IDs for other actions such as Update User and List Transactions . Example: returns { id, name } pairs such as { "id": "fffe6c22-698f-4dc5-b2b1-b35f86947d90", "name": "Engineering" } — pass the id to Update User to set a user's department. Returns one page of up to pageSize results (max 100); a page.next value in the response means more departments exist beyond this page. See the documentation (https://pipedream.com/apps/ramp/actions/list-departments) - action : List Limits — Retrieve a paginated list of Ramp spend limits. Returns a compact summary of each limit by default (id, display_name, state, balance, spend_program_id, created_at, is_shareable); use Get Limit for the full record, or pass fields to include specific extra fields. Use this to find limit IDs for Get Limit , Update Limit , and Terminate Limit . Returns one page of up to pageSize results (max 100); a page.next value in the response means more limits exist beyond this page. See the documentation (https://pipedream.com/apps/ramp/actions/list-limits) - action : List Locations — Retrieve a list of Ramp locations. Use this to find location IDs for other actions such as Update User and List Transactions . Example: returns objects like { "id": "961c6f01-5719-4f4c-8fef-4096a031f32a", "name": "New York HQ", "entity_id": "c0e5f8a2-9b1d-4e3a-8f6c-2d7b4a1e9f30" } — pass the id as the location ID in downstream actions. Returns one page of up to pageSize results (max 100); a page.next value in the response means more locations exist beyond this page. See the documentation (https://pipedream.com/apps/ramp/actions/list-locations) - action : List Spend Programs — Retrieve a list of Ramp spend programs. Returns a compact summary of each program by default (id, display_name, description, icon, is_shareable, issue_physical_card_if_needed); pass fields to include specific extra fields such as restrictions . Returns one page of up to pageSize results (max 100); a page.next value in the response means more programs exist beyond this page. See the documentation (https://pipedream.com/apps/ramp/actions/list-spend-programs) - action : List Transactions — Retrieve a paginated list of Ramp transactions, optionally filtered by department, location, or state. Returns a compact summary of each transaction by default (id, merchant_name, amount, merchant_amount, sk_category_name, state, card_id, limit_id, accounting_date, user_transaction_time, memo); use Get Transaction for the full record, or pass fields to include specific extra fields. Use this to find transaction IDs for Get Transaction . Returns one page of up to pageSize results (max 100); a page.next value in the response means more transactions exist beyond this page. See the documentation (https://pipedream.com/apps/ramp/actions/list-transactions) - action : List Transfers — Retrieve a list of Ramp transfers, optionally filtered by status. Example: pass Status ACH_CONFIRMED to return only confirmed transfers, each with amount and status. Returns one page of up to pageSize results (max 100); a page.next value in the response means more transfers exist beyond this page. See the documentation (https://pipedream.com/apps/ramp/actions/list-transfers) - action : List Users — Retrieve a paginated list of Ramp users, optionally filtered by department, location, email, role, or status. Returns a compact summary of each user by default (id, first_name, last_name, email, role, status, department_id, location_id, manager_id, is_manager); use Get User for the full record, or pass fields to include specific extra fields. Use this to discover valid user IDs for Get User and Update User . Returns one page of up to pageSize results (max 100); a page.next value in the response means more users exist beyond this page. See the documentation (https://pipedream.com/apps/ramp/actions/list-users) - action : Terminate Limit — Permanently terminate a Ramp spend limit by ID. This is irreversible and takes effect immediately. Run the List Limits action to find the limit ID. Example: given a limit id from List Limits , terminates that limit and returns its final (terminated) state. See the documentation (https://pipedream.com/apps/ramp/actions/terminate-limit) - action : Update Limit — Update an existing Ramp spend limit — rename it and/or set its spending restriction. Run the List Limits action to find the limit ID. This is a partial update: fields you omit are left unchanged. Pass Display Name alone to simply rename a limit. To set a spending cap you must provide both an Amount (in minor units, e.g. 50000 for $500.00) and an Interval (e.g. MONTHLY ); currency defaults to USD. See the documentation (https://pipedream.com/apps/ramp/actions/update-limit) - action : Update User — Update fields on an existing Ramp user (role, department, location, direct manager). Run the List Users action to find the user ID, List Departments and List Locations for related IDs. Example: to move a user into a department, pass their User ID plus a Department ID from List Departments ; you can also set role (e.g. BUSINESS_USER ), location, or direct manager. See the documentation (https://pipedream.com/apps/ramp/actions/update-user) - action : Upload Receipt — Uploads a receipt for a given transaction and user. See the documentation (https://pipedream.com/apps/ramp/actions/upload-receipt) - trigger : New Transaction Created — Emit new event for each new transaction created in Ramp. (https://pipedream.com/apps/ramp/triggers/new-transaction-created) - trigger : Transaction Status Updated — Emit new event when there is a change in transaction status. (https://pipedream.com/apps/ramp/triggers/transaction-status-updated) - trigger : Transfer Payment Updated — Emit new event when the status of a transfer payment changes (https://pipedream.com/apps/ramp/triggers/transfer-payment-updated)