Before You Begin
Before starting installation, you need a Catsy API Token. This value is required to authenticate the integration with Catsy. The API Key is the API Token found under the Catsy Users & Roles section. If you are not a Catsy administrator, your administrator can provide it.
To obtain the API Key from Catsy:
In Catsy, go to Administration > Users & Roles.
Select the user with Administrator permissions, 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.
Integration Setup
In iPaaS.com, go to Subscriptions Management > Subscriptions and click Search Certified Integration Marketplace and Subscribe.
Click the Catsy integration tile.
On the Subscription Detail page, click Subscribe.
Enter a name for the subscription and select a version. Use any relevant, unique name within the company where the subscription is created.
Format: [Product Name] - [Environment/Purpose]
Example: Catsy - MyStore
Select Create Default Mappings (recommended). Leave this unchecked only if you intend to build every mapping from scratch yourself.
Authentication Configuration
Enter the API Key. This is the Catsy API Token you retrieved in Before You Begin.
Provide the API URL for your Catsy instance.
Test/Sandbox: https://api.catsy.com/
Production: N/A
Additional Configuration
Enter the Default Parent Category For Categories — the iPaaS.com category under which Catsy categories that have no parent are placed.
Enter the Default Parent Category For Collections — the iPaaS.com category under which Catsy collections are placed. Collections have no parent in Catsy, so this determines where they appear in iPaaS.com. Many subscribers create a top-level category such as Collections.
Enter the Product Poll Search Days to override the default 5-day lookback used the first time products are polled. This applies only when no previous product poll date is saved for the subscription.
Under Allow Suffix On Duplicate Variants, select True or False. When True, if a Catsy product's base variant has the same SKU as its parent product, the integration appends -BASE to that variant's SKU — for example, NOR1882104 becomes NOR1882104-BASE — so the product transfers with all of its variants; only the colliding variant is changed and the others transfer unchanged. When False, iPaaS.com rejects the product, because it requires every variant SKU to differ from its parent product's SKU, and none of the product transfers. Default: False.
Enter the API Throttle Limit — the number of requests the integration may send within the throttle window. Recommended value: 500.
Enter the API Throttle Seconds — the length of the throttle window in seconds. Default: 60.
Enter the number of Concurrent Connections — the maximum number of simultaneous connections the integration uses. Default: 10.
Enter the number of Concurrent Batch Executions — the maximum number of batch operations the integration runs at the same time. Default: 10.
Click Apply to save the settings.
Post-Installation Verification
After completing the installation, verify the integration:
Data Sync Test
Initiate a sample transfer to iPaaS.com (for example, sync one Catsy product by its ID from the Manual Sync page).
Initiate a sample transfer from iPaaS.com.
Functionality Test
Run an end-to-end transfer and confirm the record appears in the destination.
Review the transfer in the iPaaS.com Dashboard under Integration Monitoring and check the Error Logs for any issues.
Support and Troubleshooting
Click the Help button on any iPaaS.com page to contact Support or search the documentation.
Documentation: search the Help Center from the top of this article.
Support Portal: click the Help and Support button at the lower-right of the window.
Contact Information: Contact iPaaS.com