> ## Documentation Index
> Fetch the complete documentation index at: https://docs.engini.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Coupa
Let's learn how to connect Engini to Coupa.
This integration connects Engini workflows with Coupa procurement and spend management, allowing you to start workflows when suppliers or other records are created or updated, read, create, update and delete records, submit requisitions and expense reports for approval, approve or reject pending approvals, manage purchase orders, add attachments, and send custom requests to the Coupa API directly from your workflows.
To get started, visit [Coupa](https://www.coupa.com) to get access to a Coupa instance.
## Add a Connection to Coupa in Engini
### Prerequisites
* A Coupa instance and its URL, for example `https://your-instance.coupahost.com`.
* An OAuth2 client (Client ID and Client Secret) created in Coupa, with the scopes your workflows need.
**Note:** To approve or reject approvals, the client needs the `core.approval.read` and `core.approval.write` scopes. The supplier triggers need `core.supplier.read`.
### Retrieve your Coupa Client ID and Client Secret
1. Log in to your Coupa instance as an administrator.
2. Go to Setup > Oauth2/OpenID Connect Clients and click Create.
3. Set the Grant type to Client Credentials.
4. Enter a name and a unique login for the client, and fill in the contact details Coupa asks for.
5. Select the scopes you need: `core.approval.read` and `core.approval.write` for approvals, and `core.supplier.read` for the supplier triggers.
6. Save the client. Coupa shows the client's Identifier (your Client ID) and its Secret (your Client Secret).
### Connecting Engini to Coupa
1. Enter your Engini account at [https://app.engini.io](https://app.engini.io/).
2. Navigate to the Connections page by clicking on Connections in the left sidebar or by clicking [here](https://app.engini.io/connections).
3. Click on the "New Integration" option located at the top bar.
4. Choose the Coupa option from the available applications.
5. Enter the following details in the "New Integration" form and press Save:
- *Connection Name -* Enter a name that helps identify the Coupa connection.
- *Coupa Instance URL -* Enter the address of your Coupa instance, in the format `https://your-instance.coupahost.com`.
- *Client ID -* Enter the Identifier of the OAuth2 client you created in Coupa.
- *Client Secret -* Enter the Secret of the OAuth2 client.
- *Scopes -* Optional. Enter the scopes the connection may use, separated by spaces. The field comes filled with `core.approval.read core.approval.write core.supplier.read`, which covers Grant an Approval, Reject an Approval and both supplier triggers. Add any other scopes your Send API Request calls need.
- *Save -* Click Save to create the connection.
There is no sign-in screen. Engini uses the Client ID and Client Secret to get an access token from your Coupa instance, so you don't need to add credentials to any action.
## Triggers
### Check for New Suppliers
Starts the workflow when new suppliers have been created in Coupa since the last check.
1. *Starting (UTC) -* Select the start date and time for the scheduled trigger.
2. *Recur every -* Choose the time interval for triggering and checking suppliers. The minimum time interval is 15 minutes.
3. *Add time frame -* You can specify a time frame during which the trigger will operate.
4. *Add Conditions -* Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-conditions).
**Note:** Conditions return only the suppliers that match, for example Status equals active. The condition fields include ready-made ones such as Name Contains, Status Is Not and Created On Or After.
**Output:** Each run returns the suppliers created since the previous run, one record per supplier. Every record holds these fields:
* ID
* Name
* Display Name
* Supplier Number
* Status
* On Hold
* DUNS Number
* Tax ID
* Website
* Primary Contact
* Payment Method
* PO Method
* PO Email
* Invoice Matching Level
* Created At
* Updated At
### Check for Updated Suppliers
Starts the workflow when suppliers have been updated in Coupa since the last check.
1. *Starting (UTC) -* Select the start date and time for the scheduled trigger.
2. *Recur every -* Choose the time interval for triggering and checking suppliers. The minimum time interval is 15 minutes.
3. *Add time frame -* You can specify a time frame during which the trigger will operate.
4. *Add Conditions -* Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-conditions).
**Note:** Conditions return only the suppliers that match, for example Status equals active. The condition fields include ready-made ones such as Name Contains, Status Is Not and Created On Or After.
**Output:** Each run returns the suppliers updated since the previous run, one record per supplier. Every record holds these fields:
* ID
* Name
* Display Name
* Supplier Number
* Status
* On Hold
* DUNS Number
* Tax ID
* Website
* Primary Contact
* Payment Method
* PO Method
* PO Email
* Invoice Matching Level
* Created At
* Updated At
### Check for New Records
Starts the workflow when records of the selected type have been created in Coupa since the last check.
- *Object Type -* Select the type of record to watch: Invoices, Purchase Orders, Requisitions, Suppliers, Users, Items, Accounts, Contracts, Expense Reports, Receipts, Commodities or Departments.
- *Starting (UTC) -* Select the start date and time for the scheduled trigger.
- *Recur every -* Choose the time interval for triggering and checking records. The minimum time interval is 15 minutes.
- *Add time frame -* You can specify a time frame during which the trigger will operate.
- *Add Conditions -* Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-conditions).
**Output:** Each run returns the records created since the previous run, one item per record. The fields depend on the Object Type you selected.
### Check for Updated Records
Starts the workflow when records of the selected type have been updated in Coupa since the last check.
- *Object Type -* Select the type of record to watch: Invoices, Purchase Orders, Requisitions, Suppliers, Users, Items, Accounts, Contracts, Expense Reports, Receipts, Commodities or Departments.
- *Starting (UTC) -* Select the start date and time for the scheduled trigger.
- *Recur every -* Choose the time interval for triggering and checking records. The minimum time interval is 15 minutes.
- *Add time frame -* You can specify a time frame during which the trigger will operate.
- *Add Conditions -* Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-conditions).
**Output:** Each run returns the records updated since the previous run, one item per record. The fields depend on the Object Type you selected.
## Actions
### Grant an Approval
Approves a pending approval in Coupa.
1. *Approval ID -* Select the pending approval from the list, or map its ID from a previous step in your workflow.
2. *Add Field -* Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-fields).
All of the following are optional and are added through Add Field:
* *Approver User ID -* The ID of the Coupa user to act as. That user must be the approver of this approval.
**Note:** Only approvals that are still pending can be approved.
### Reject an Approval
Rejects a pending approval in Coupa.
1. *Approval ID -* Select the pending approval from the list, or map its ID from a previous step in your workflow.
2. *Add Field -* Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-fields).
All of the following are optional and are added through Add Field:
* *Reason -* The reason for the rejection, sent to Coupa with it.
* *Approver User ID -* The ID of the Coupa user to act as. That user must be the approver of this approval.
**Note:** Only approvals that are still pending can be rejected.
### Get Record
Retrieves a single Coupa record of the selected type.
- *Object Type -* Select the type of record to retrieve: Invoices, Purchase Orders, Requisitions, Suppliers, Users, Items, Accounts, Contracts, Expense Reports, Receipts, Commodities or Departments.
- *Record ID -* Select the record from the list, or map its ID from a previous step in your workflow.
### Get Records
Retrieves multiple Coupa records of the selected type, optionally limiting the number of results and applying filters or sorting.
- *Object Type -* Select the type of record to retrieve: Invoices, Purchase Orders, Requisitions, Suppliers, Users, Items, Accounts, Contracts, Expense Reports, Receipts, Commodities or Departments.
- *Top N -* You can set the maximum number of records Engini will return (default = 50, minimum = 1).
- *Add Filter -* Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-filters).
- *Add Sort -* Click Add Sort to organize the data list by a selected field in ascending or descending order. To learn more about sorting data, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-sorts).
### Create Record
Creates a new record of the selected type in Coupa.
- *Object Type -* Select the type of record to create: Invoices, Purchase Orders, Requisitions, Suppliers, Users, Items, Accounts, Contracts, Expense Reports, Receipts, Commodities or Departments.
- *Add Field -* Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-fields).
**Note:** The fields you can add depend on the Object Type you selected.
### Update Record
Updates an existing record of the selected type in Coupa.
- *Object Type -* Select the type of record to update: Invoices, Purchase Orders, Requisitions, Suppliers, Users, Items, Accounts, Contracts, Expense Reports, Receipts, Commodities or Departments.
- *Record ID -* Select the record from the list, or map its ID from a previous step in your workflow.
- *Add Field -* Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-fields).
**Note:** The fields you can add depend on the Object Type you selected.
### Delete Record
Deletes a record in Coupa. Only Requisitions and Receipts can be deleted.
- *Object Type -* Select Requisitions or Receipts.
- *Record ID -* Select the record from the list, or map its ID from a previous step in your workflow.
### Submit Requisition for Approval
Submits a requisition to start its approval in Coupa.
*Requisition ID -* Select the requisition from the list, or map its ID from a previous step in your workflow.
### Get Approvals
Retrieves multiple approvals from Coupa, optionally limiting the number of results and applying filters or sorting.
- *Top N -* You can set the maximum number of approvals Engini will return (default = 50, minimum = 1).
- *Add Filter -* Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-filters).
- *Add Sort -* Click Add Sort to organize the data list by a selected field in ascending or descending order. To learn more about sorting data, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-sorts).
### Get Approval
Retrieves a single approval from Coupa.
*Approval ID -* Select the approval from the list, or map its ID from a previous step in your workflow.
### Cancel Purchase Order
Cancels a purchase order in Coupa.
*Purchase Order ID -* Select the purchase order from the list, or map its ID from a previous step in your workflow.
### Close Purchase Order
Closes a purchase order in Coupa.
*Purchase Order ID -* Select the purchase order from the list, or map its ID from a previous step in your workflow.
### Request Purchase Order Change
Requests a change to an existing purchase order in Coupa.
*Add Field -* Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-fields).
Add the fields of the change request through Add Field. *Order Header Id -* The purchase order the change applies to; select it from the list, or map its ID from a previous step in your workflow.
### Submit Expense Report for Approval
Submits an expense report to start its approval in Coupa.
*Expense Report ID -* Select the expense report from the list, or map its ID from a previous step in your workflow.
### Set Integration Run Status
Sets the status of an integration run in Coupa.
- *Integration Run ID -* Select the integration run from the list, or map its ID from a previous step in your workflow.
- *Status -* Select the status to set: Running, Successful, Failed, Paused or Pending.
### Add Attachment
Attaches a file, a link or a text note to a record in Coupa.
- *Object -* Select the type of record to attach to: Contracts, Invoices, Expense Reports, Purchase Orders, Users or Requisitions.
- *Record Id -* Enter the ID of the record to attach to, or map it from a previous step in your workflow.
- *Type -* Select what you are attaching. The default is File. The fields below the Type depend on it, and only the matching ones are shown.
- *File name -* Shown when Type is File. Enter the name of the file, including its extension, for example `invoice.pdf`.
- *File content -* Shown when Type is File. Enter the content of the file as a base64 string, or map it from a previous step in your workflow.
- *Add Field -* Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](https://docs.engini.ai/help/workflows/workflow-editor.md#add-fields).
With Type set to URL, a URL field replaces the file fields. Enter the address of the link to attach.
With Type set to Text, a Text field replaces the file fields. Enter the text of the note to attach.
**Note:** The optional Intent field is available through Add Field.
### Send API Request
This activity allows you to send a custom API request directly to Coupa's API.
1. *Base Url -* The root URL of the Coupa API. It is filled in from your Coupa connection and can't be edited here.
2. *Relative url -* You can specify additional path segments or parameters that need to be added to the end of the Base Url. This allows you to customize the specific request you want to perform.
3. *Method -* Select the HTTP method (e.g., Get, Post, Put, Delete, Patch). The default is POST.
4. *Body Type -* Defines the format of the data in the body of your request. The default, application/json, means the body contains a JSON-formatted payload.
5. *Body -* Contains any data that is being sent to the server.
6. *Add Headers -* Additional metadata about the request, such as the type of data Engini can accept, the length of the request body, and authentication information.
7. *Add Queries -* The query refers to the parameters or data that are included in the URL of an HTTP request to provide additional information or instructions to the server.
For the full list of endpoints, see the [Coupa Core API documentation](https://compass.coupa.com/en-us/products/product-documentation/integration-technical-documentation/the-coupa-core-api).
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.