Before You Begin
Before starting installation, you need to obtain an API Key. This subscription preset is required to authenticate Catsy APIs. API Key is the API Token found under the Catsy Users & Roles section. If you are not a Catsy administrator, your administrator can provide this.
To obtain the API Key from Catsy:
Navigate to Administration > Users & Roles.
Select the user with Administrator permissions, and then copy the API Token value and save it in a safe place. You will need it to complete your subscription.
Continue with the next section.
Installation Instructions for Integration Setup
Go to Subscriptions Management > Subscriptions and click Search Certified Integration Marketplace and Subscribe.
Click the Catsy Integration title.
On the Subscription Detail page, click the Subscribe button.
Enter the name of the subscription and select a version. It can be set to any relevant and unique subscription name within the company where this subscription is created.
Format: [Product Name] - [Environment/Purpose]
Example: Catsy – MyStore
Select Create Default Mappings (recommended).
NOTE: If you don’t want to create default mappings and want to create all mappings from scratch by yourself then uncheck this box.
Enter the API Key. This is the API token you retrieved and saved from Catsy in Before You Begin.
Provide the API URL endpoint for your Catsy instance.
Environment URLs:
Test/Sandbox: https://api.catsy.com/
Production: N/A
Enter the Default Parent Category for Categories, a default applied to categories with no parent category.
Enter the Default Parent Category for Collections, a default applied to collections with no parent category. Most users create a top-level category called "Campaigns" or "Collections".
Enter the Product Poll Search Days, which can be used to override the default 5-day search limit for first-time polling events. This setting only applies when there is no previous product poll date saved in the subscription's persistent data.
Enter the API Throttle Limit. This setting prevents any single integration or user from overwhelming the system with too many requests. It protects system performance by controlling the number of API requests that can run simultaneously, ensuring fair usage.
Recommended Values
Initial Setup: 5
Ongoing Operations: 500
High Volume: 500
Enter the API Throttle Seconds. This defines the time window during which the API Throttle Limit is measured. If an integration makes too many requests within this time window, additional requests are rejected until the window resets.
Default Value: 60 seconds
Range: 60 seconds
Enter the number of Concurrent Connections. This specifies the maximum number of simultaneous API connections that Akeneo can process for a user or integration. If this limit is exceeded, new requests are queued or rejected until a currently active connection finishes.
Default Value: 5
Range: 10
Enter the number of Concurrent Batch Executions. This specifies the maximum number of simultaneous batch executions that can process for an integration at one time. . If this limit is exceeded, new requests are queued or rejected until a currently active connection finishes.
Default Value: 5
Range: 10
Click Apply to save the settings.
Post-Installation Verification
After completing the installation, verify the integration by performing the following tests.
Data Sync Test
Initiate a sample data pull. (To iPaaS.com)
Initiate a sample data push. (From iPaaS.com)
Functionality Test
Run an end-to-end business process.
Validate key features like field mappings, workflow triggers, and logging.
Review integration logs in iPaaS.
Support and Troubleshooting
Click the Help button on any iPaaS.com page to contact Support or to search our documentation.
Documentation: Search our documentation at the top of this article
Support Portal: Click the Help and Support button at the lower-right of this window
Contact Information: Contact iPaaS.com