Concur
SAP Concur expense management.
What you can ask
- List all expense reports in
Submittedstatus that haven't been approved in more than 5 days. - Pull every expense entry on my open report and flag any that are missing a receipt attachment.
- Pull every expense entry coded to
Meals & Entertainmentsubmitted this quarter across the sales team.
Set up
Concur needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find Concur. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Concur developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or Concur login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
OAuth scopes used by these tools (10)
Grant the scopes for the tools you plan to allow.
IMAGEexpense.config.paymenttypes.restricted.readexpense.report.readexpense.report.readwriteidentity.user.core.readidentity.user.ids.readquickexpense.writeonlyreceipts.readreceipts.readwriteuser.read
Tools
Concur offers 40 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (25)
View and search information without changing it.
| Tool | What it does |
|---|---|
download_expense_receipt_image | Download an expense receipt's image bytes by the receiptImageId of an expense report entry (receiptImageId/ereceiptImageId). |
download_image_only_receipt | Download an image-only receipt's bytes (a user-uploaded receipt image, no merchant data) by a receipt_id from list_image_only_receipts. |
download_receipt | Download an e-receipt's image bytes (a merchant-delivered receipt in the user's Concur receipt library) by a receipt_id from list_user_receipts or get_receipt. |
get_current_user | Get the authenticated user or company profile from /profile/v1/me. |
get_expense_form_fields | Get form-field metadata for an expense entry (custom fields by expense type). |
get_expense_receipt_image | Get metadata and a temporary (~15 min) download URL for an expense receipt image WITHOUT downloading the bytes, given a receiptImageId from an Expense Report expense entry (receiptImageId/ereceiptImageId). |
get_image_only_receipt | Get an image-only receipt's metadata by receipt_id (a user-uploaded receipt image in the receipt library, no merchant-extracted data; receipt_id comes from list_image_only_receipts). |
get_principal | Get a Concur principal (user or company) by ID via /profile/v1/principals/{id}. |
get_receipt | Get an e-receipt's metadata by receipt_id (a merchant-delivered digital receipt in the user's Concur receipt library; receipt_id comes from list_user_receipts). |
get_receipt_status | Get the processing status of a submitted receipt by receipt_id (from list_user_receipts or an upload response). |
get_report | Get an expense report by ID. |
get_report_expense | Get a single expense entry on a report including amount, date, location, and custom fields. context_type accepts TRAVELER (default), MANAGER, or PROXY — MANAGER works here even though list_report_expenses rejects it. |
get_report_form_fields | Get policy-driven form-field metadata for a report (data type, required flag, access level). |
list_expense_itemizations | List itemizations on an expense entry — itemizations split a single charge across multiple expense types or amounts. |
list_image_only_receipts | List image-only receipts in the user's receipt library. |
list_payment_types | List payment types available to a Concur user (e.g. 'Cash', 'Company Paid') via Expense Config v4. |
list_report_exceptions | List policy exceptions on a report. |
list_report_expenses | List all expense entries on a report. |
list_reports | List the authenticated user's expense reports. |
list_reports_to_approve | List reports the authenticated user can approve as an approver or delegate. |
list_user_receipts | List e-receipts for the authenticated user. |
list_users | List Concur users in the company via Identity v4.1 (SCIM). |
read_receipt_text | Read a receipt's file as text; prefer over the download tools to READ. receipt_source: 'receipt' (receipt_id from list_user_receipts), 'image_only_receipt' (list_image_only_receipts) or 'expense_receipt_image' (an expense entry's receiptImageId). |
search_users | Search Concur users via Identity v4.1 SCIM (POST /Users/.search). |
validate_credential | Validate the connected Concur account by fetching the authenticated principal's profile. |
Write (7)
Create or send data.
| Tool | What it does |
|---|---|
attach_receipt_to_expense | Upload a receipt image and attach it directly to an expense entry. |
create_quick_expense | Create a quick expense (no image) for the authenticated user. |
create_quick_expense_with_image | Create a quick expense and attach a receipt image in one call. |
create_report | Create a new (unsubmitted) expense report. context_type accepts only TRAVELER (default) or PROXY. policy_id MUST be a v4 ID: call list_reports, pick any report, call get_report on it, and use the policy_id from that v4 response. |
create_report_expense | Create a new expense entry on an existing report. |
upload_receipt | Upload an e-receipt (image + structured metadata) to the user's receipt library. |
upload_receipt_image_only | Upload an image-only receipt to the user's receipt library. |
Delete or overwrite (8)
Remove or replace existing data.
| Tool | What it does |
|---|---|
approve_report | Approve a submitted expense report (MANAGER context). |
delete_report | Permanently delete an expense report. |
delete_report_expense | Permanently delete an expense entry from a report. |
sendback_report | Send a submitted report back to the submitter for changes (MANAGER context). |
submit_report | Submit an unsubmitted expense report for approval. |
update_report | Update fields on an unsubmitted report. context_type accepts only TRAVELER (default) or PROXY. report_source is required by Concur (one of OTHER/SE/UI/EA/TR/MOB; use 'OTHER' for API callers). |
update_report_as_company | Update a report using a company-level JWT. |
update_report_expense | Update a single expense entry on a report. |