API for Plytix

How to set up API Keys, plan limits, and documentation

Plytix offers an API which enables other applications to create, edit and extract information from Plytix directly. This is essential in case you need to integrate an ERP system or any other service with Plytix. In this article, you will learn how to access the API documentation, what the current plan limits are, and how to create and manage API Keys.

ℹ️ Only Owners and Admins can create and manage API keys.


Documentation

Plan Limits

Creating API credentials (keys)

Assigning API Roles

 

*Skip to any section in this article by clicking on the links above

 


Documentation

In order to learn how the API works in detail, jump over to http://apidocs.plytix.com to access the technical documentation.

 


 

Plan Limits

Plytix has two plan types with distinct rate limits for the API. All rate limits are applied based on account. These limits are enforced on all the resources available in the API. 

FREE

Each account in the Free plan is allowed 20 requests every 10 seconds, capped at 2000 requests per hour. 

PAID

Each account in the Starter, Custom, and Unlimited plans are allowed 50 requests every 10 seconds, capped at 5000 requests per hour.

 


 

Creating API Keys

API Keys are required before you can create a successful integration with the Plytix API. 

⚠️ The API credentials allow access to manipulate the data in your account, so only share the API credentials with trusted contacts and services.

 

To create API credentials, you must have Admin rights.

How to generate an API Key

  1. Go to accounts.plytix.com
  2. Locate the API tab.Navigate to the API tab of the account settings area.
  3. Click 'Create API Key.'Create a new API Key by clicking on the 'Create API Key' button.
  4. Give your Key a name and set the role of the API key, which will determine access rights.To create your new Key, give it a name and select a role.
  5. Click 'Create API Key' to save.To save the new API key, click 'Create API Key,' which will save it.

💡 We recommend identifying the integration or party who will be using the Key directly in the name so that you know who has access to a particular Key.

 

To reveal the API Password, hover near it and click the eye icon. 

To reveal your API password, click on the eye icon to show it.

You can also edit and delete API keys using the icons next to the assigned role. You may also edit or remove API Keys by clicking on the corresponding icons.

 


 

Assigning API Roles

API Roles allow you to determine how much access the API Key has to your data in the PIM.  You can assign and change an API key role in the 'API' tab in the Account Administration section of Plytix.

 

To assign an API Key to a new role: 

  1. Go to the API Key you want to edit.
  2. Click the pencil icon on the right and a pop up will appear.
    To edit the name or role of an API Key, click on the pencil icon.
  3. Edit the Key name or choose a new role from the dropdown.After making edits to the name or role, click 'Save API Key.'
  4. Click 'Save API Key' to save and apply your changes.

 

⚠️ Changing an existing API Key Role can result in the malfunctioning of your integration. Check before you change!

ℹ️ API Roles are managed the same way as user roles in the Account Administration section under the "Roles" tab. The two types of user roles are System Roles and custom Team Roles. 

 


What's next?

 

If you have any questions just click on the chat box in the bottom-right corner and we'll be happy to answer them...


and please let us know 👇