1. Data Pull arrow-right
  2. Integration Settings

Integration Settings

Add an Integration

Now that the connection is set up, go to the Apps tab and click Data Pull. There you'll see the list of integrations, and a button to add a "New Integration" in the top-right corner. Click to get started.

 Data pull integrations

Give the integration a name, ideally one that demonstrates what kind of data it will be used to send. Set the type to "Order" or "Material" depending on the kind of data you're pulling, and select the connection you set up in the first step.

Integration Settings

Once an integration is created, you can click on it to look at the details. In the Settings tab, you'll see these options:

  • General: Change the integration name or connection.
  • Connection: This is the path/extension of the connection base URL.
  • Headers: Add or remove headers that should be included, like authorization tokens.
  • Request: Use either a GET or POST API method to pull data.
  • Confirmation: Set the endpoint to send confirmation responses.

You can toggle the entire integration to "Inactive" with the switch at the top-right.

 Data pull general

Connection

The Path entered here is the endpoint where orders or materials are being pulled from. The path is an extension of the Data Pull connection set up in ItemPath's global settings.

Checking the "Verify" box will require SSL certification verification for this endpoint.

Timeout is the number of seconds that can pass without a response before Data Pull logs a timeout error. The default is 10 seconds.

 Data pull connection

Headers

The headers entered here will apply to each transaction sent with this integration. These are also in addition to any global headers set up in the Data Pull connection.

Check the "Private" box if these headers are used for authentication and should not be shown in the logs.

 Data push settings headers

Request

Change the default API method from GET to POST and enter the body of the request, if you need to pull data that way.

Confirmations

Set the endpoint to send confirmation responses to once an order or material has been created. Mappings for this are in the next step.

 Data pull request confirmations