# Fiche connecteur Ramp (Sandbox Version)
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 (Sandbox Version)
URL : https://get-bruno.com/features/connectors/ramp-sandbox
Référence texte : https://get-bruno.com/features/connectors/ramp-sandbox/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Gestion d’entreprise
Description : Ramp (Sandbox Version) est un environnement de test pour utiliser l’API Ramp sans toucher aux données de production. Il permet de gérer des objets Sandbox comme les départements, sites, utilisateurs, limites, programmes de dépenses, cartes virtuelles, transactions, transferts et reçus.
Authentification : OAuth
Présentation : Ramp (Sandbox Version) est un environnement de test pour utiliser l’API Ramp sans toucher aux données de production. Il permet de gérer des objets Sandbox comme les départements, sites, utilisateurs, limites, programmes de dépenses, cartes virtuelles, transactions, transferts et reçus.
Usage : Mettre à jour le département d’un utilisateur
Exemple de demande : Je veux vérifier le service actuel de Claire Bernard puis la déplacer dans Marketing avec le bon responsable.
Résultat attendu : Je retrouve l’utilisateur, je vérifie ses champs actuels, puis je mets à jour son département et, si besoin, son responsable direct à l’aide des identifiants valides.
À préciser : Nom ou adresse e-mail de l’utilisateur ; Nom ou identifiant du département cible ; Identifiant du responsable direct si je dois aussi le renseigner
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/ramp-sandbox/actions/list-users ; https://pipedream.com/apps/ramp-sandbox/actions/list-departments ; https://pipedream.com/apps/ramp-sandbox/actions/get-user ; https://pipedream.com/apps/ramp-sandbox/actions/update-user
Usage : Créer une carte virtuelle adossée à un programme de dépenses
Exemple de demande : Je veux créer une carte virtuelle pour Atelier Martin, avec le nom Marketing SaaS et une limite mensuelle de 500 USD.
Résultat attendu : J’émets la carte virtuelle pour l’utilisateur cible avec le nom demandé ; je peux la lier à un programme de dépenses existant ou appliquer une limite personnalisée de 500 USD par mois.
À préciser : Identifiant de l’utilisateur à qui rattacher la carte ; Nom de la carte virtuelle ; Choix entre programme de dépenses existant ou limite personnalisée ; Identifiant du programme de dépenses si la carte doit suivre un programme existant
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/ramp-sandbox/actions/list-users ; https://pipedream.com/apps/ramp-sandbox/actions/list-spend-programs ; https://pipedream.com/apps/ramp-sandbox/actions/issue-virtual-card
Usage : Retrouver une transaction et téléverser son reçu
Exemple de demande : Je veux retrouver la transaction Facebook Ads de 135 USD puis téléverser le reçu correspondant.
Résultat attendu : Je liste les transactions, j’ouvre la transaction ciblée, puis je téléverse le reçu en le rattachant à cette transaction et à l’utilisateur concerné.
À préciser : Identifiant ou critères de recherche de la transaction ; Identifiant de l’utilisateur concerné ; Fichier du reçu à téléverser
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/ramp-sandbox/actions/list-transactions ; https://pipedream.com/apps/ramp-sandbox/actions/get-transaction ; https://pipedream.com/apps/ramp-sandbox/actions/upload-receipt
Limites propres au service : Les listes sont paginées et ne renvoient qu’une page à la fois. Plusieurs actions demandent d’abord un identifiant obtenu via une liste ciblée. La terminaison d’une limite est irréversible et prend effet immédiatement. Cette fiche concerne l’environnement Sandbox, pas la production.
Vocabulaire français : Créer un département — Crée un nouveau département Ramp Sandbox, par exemple Engineering ou Marketing, pour organiser les utilisateurs. (https://pipedream.com/apps/ramp-sandbox/actions/create-department)
Vocabulaire français : Créer un site — Crée un nouveau site Ramp Sandbox, par exemple New York HQ, avant d’y rattacher des utilisateurs. (https://pipedream.com/apps/ramp-sandbox/actions/create-location)
Vocabulaire français : Inviter un utilisateur — Envoie une invitation par e-mail à une nouvelle personne pour créer son accès dans l’organisation Sandbox. (https://pipedream.com/apps/ramp-sandbox/actions/create-user-invite)
Vocabulaire français : Obtenir une limite — Récupère une seule limite de dépenses à partir de son identifiant. (https://pipedream.com/apps/ramp-sandbox/actions/get-limit)
Vocabulaire français : Obtenir une transaction — Récupère une transaction précise à partir de son identifiant. (https://pipedream.com/apps/ramp-sandbox/actions/get-transaction)
Vocabulaire français : Obtenir un utilisateur — Récupère la fiche complète d’un utilisateur à partir de son identifiant. (https://pipedream.com/apps/ramp-sandbox/actions/get-user)
Vocabulaire français : Émettre une carte virtuelle — Crée une carte virtuelle pour un utilisateur, avec soit un programme de dépenses existant, soit une limite personnalisée. (https://pipedream.com/apps/ramp-sandbox/actions/issue-virtual-card)
Vocabulaire français : Lister les départements — Retourne la liste des départements pour retrouver les identifiants utilisables dans les autres opérations. (https://pipedream.com/apps/ramp-sandbox/actions/list-departments)
Vocabulaire français : Lister les limites — Retourne la liste paginée des limites de dépenses et leurs informations de synthèse. (https://pipedream.com/apps/ramp-sandbox/actions/list-limits)
Vocabulaire français : Lister les sites — Retourne la liste paginée des sites pour retrouver les identifiants utilisables dans les autres opérations. (https://pipedream.com/apps/ramp-sandbox/actions/list-locations)
Vocabulaire français : Lister les programmes de dépenses — Retourne la liste paginée des programmes de dépenses disponibles dans le Sandbox. (https://pipedream.com/apps/ramp-sandbox/actions/list-spend-programs)
Vocabulaire français : Lister les transactions — Retourne la liste paginée des transactions, avec filtres possibles par département, site ou état. (https://pipedream.com/apps/ramp-sandbox/actions/list-transactions)
Vocabulaire français : Lister les transferts — Retourne la liste des transferts, avec un filtre possible sur leur statut. (https://pipedream.com/apps/ramp-sandbox/actions/list-transfers)
Vocabulaire français : Lister les utilisateurs — Retourne la liste paginée des utilisateurs, avec filtres possibles par département, site, e-mail, rôle ou statut. (https://pipedream.com/apps/ramp-sandbox/actions/list-users)
Vocabulaire français : Terminer une limite — Met fin définitivement à une limite de dépenses à partir de son identifiant. (https://pipedream.com/apps/ramp-sandbox/actions/terminate-limit)
Vocabulaire français : Mettre à jour une limite — Modifie une limite existante, par exemple son nom ou sa restriction de dépense. (https://pipedream.com/apps/ramp-sandbox/actions/update-limit)
Vocabulaire français : Mettre à jour un utilisateur — Modifie certains champs d’un utilisateur existant, comme son rôle, son département, son site ou son responsable direct. (https://pipedream.com/apps/ramp-sandbox/actions/update-user)
Vocabulaire français : Téléverser un reçu — Ajoute un reçu à une transaction donnée pour un utilisateur donné. (https://pipedream.com/apps/ramp-sandbox/actions/upload-receipt)
Vocabulaire français : Nouvelle transaction créée — Déclenche un événement à chaque nouvelle transaction créée dans Ramp. (https://pipedream.com/apps/ramp-sandbox/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-sandbox/triggers/transaction-status-updated)
Vocabulaire français : Statut de paiement de transfert mis à jour — Déclenche un événement quand le statut d’un paiement de transfert change. (https://pipedream.com/apps/ramp-sandbox/triggers/transfer-payment-updated)
- action : Create Department — Create a new Ramp Sandbox 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-sandbox/actions/create-department)
- action : Create Location — Create a new Ramp Sandbox 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-sandbox/actions/create-location)
- action : Create User Invite — Invite a new person to your Ramp Sandbox organization by email — use this to onboard an employee who doesn't yet have a Ramp Sandbox 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-sandbox/actions/create-user-invite)
- action : Get Limit — Retrieve a single Ramp Sandbox 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-sandbox/actions/get-limit)
- action : Get Transaction — Retrieve a single Ramp Sandbox 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-sandbox/actions/get-transaction)
- action : Get User — Retrieve a single Ramp Sandbox 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-sandbox/actions/get-user)
- action : Issue Virtual Card — Issue a new Ramp Sandbox virtual card (spend limit) for a user. Requires a Virtual Card Name and the user's ID (run List Users to find it). 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, allowed/blocked categories, and whether the physical card ( Primary Card Enabled ) and Reimbursements Enabled apply. Example: issue a $500/month card by passing a Virtual Card Name (e.g. Marketing SaaS ), the user's ID, $500 , and MONTHLY . See the documentation (https://pipedream.com/apps/ramp-sandbox/actions/issue-virtual-card)
- action : List Departments — Retrieve a list of Ramp Sandbox 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-sandbox/actions/list-departments)
- action : List Limits — Retrieve a paginated list of Ramp Sandbox 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-sandbox/actions/list-limits)
- action : List Locations — Retrieve a list of Ramp Sandbox 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-sandbox/actions/list-locations)
- action : List Spend Programs — Retrieve a list of Ramp Sandbox 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-sandbox/actions/list-spend-programs)
- action : List Transactions — Retrieve a paginated list of Ramp Sandbox 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-sandbox/actions/list-transactions)
- action : List Transfers — Retrieve a list of Ramp Sandbox 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-sandbox/actions/list-transfers)
- action : List Users — Retrieve a paginated list of Ramp Sandbox 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-sandbox/actions/list-users)
- action : Terminate Limit — Permanently terminate a Ramp Sandbox 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-sandbox/actions/terminate-limit)
- action : Update Limit — Update an existing Ramp Sandbox 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 the currency's smallest denomination — e.g. 50000 = $500.00 in USD, or 500 = ¥500 in JPY) and an Interval (e.g. MONTHLY ); currency defaults to USD. See the documentation (https://pipedream.com/apps/ramp-sandbox/actions/update-limit)
- action : Update User — Update fields on an existing Ramp Sandbox 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-sandbox/actions/update-user)
- action : Upload Receipt — Uploads a receipt for a given transaction and user. See the documentation (https://pipedream.com/apps/ramp-sandbox/actions/upload-receipt)
- trigger : New Transaction Created — Emit new event for each new transaction created in Ramp. (https://pipedream.com/apps/ramp-sandbox/triggers/new-transaction-created)
- trigger : Transaction Status Updated — Emit new event when there is a change in transaction status. (https://pipedream.com/apps/ramp-sandbox/triggers/transaction-status-updated)
- trigger : Transfer Payment Updated — Emit new event when the status of a transfer payment changes (https://pipedream.com/apps/ramp-sandbox/triggers/transfer-payment-updated)