Skip to main content

Authorization

Follow this guide to create a new Precoro credential that will allow Nexla to authenticate to and exchange data with your Precoro account.
precoro_api_auth.png

Precoro

Prerequisites​

To connect Nexla to Precoro, you will need a Precoro API key and the email address of the Precoro user who generated it. Precoro authenticates API requests using two request headers: an X-AUTH-TOKEN header containing your API token and an email header containing the associated user's email address.

Generate a Precoro API Key​

Precoro API keys are user-specific—the key inherits the roles and permissions of the user who generated it, including access restrictions based on Locations, Departments, and Projects. For the broadest data access, generate the API key under a user account with the appropriate administrative permissions.

  1. Sign in to your Precoro account.

  2. Navigate to Configuration > Integrations > API Key.

  3. Click the Generate API Key button in the upper right corner of the page.

Important

The API key is displayed only once, at the moment of generation. Copy and store it immediately in a secure location—you will not be able to view it again in Precoro. If the key is lost, you must generate a new one.

  1. Note the email address of the Precoro user account under which the key was generated. This email address is required along with the API token when configuring the Nexla credential.

If your organization has multiple companies configured in Precoro, a separate API key must be generated for each company. The key is scoped to a single company at a time.

For additional information about Precoro API authentication, refer to the Precoro API documentation and the Precoro Knowledge Base.

Create a Precoro Credential​

  • To create a new Precoro credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used to provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Token (X-AUTH-TOKEN)​

  1. Enter your Precoro API key in the API Token (X-AUTH-TOKEN) field. This is the key generated in Precoro under Configuration > Integrations > API Key. The token is transmitted as the X-AUTH-TOKEN request header in all API calls Nexla makes to the Precoro API.

User Email​

  1. Enter the email address of the Precoro user who generated the API key in the User Email field. This email is transmitted as the email request header in all API calls and must match the account associated with the API token. The API key inherits this user's roles and data access permissions.

Ensure that the user account whose email is entered here has the necessary Precoro permissions to access the data objects (purchase orders, invoices, suppliers, etc.) that you intend to integrate with Nexla. Access restrictions by Location, Department, or Project configured in Precoro will be respected when Nexla queries the API.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.