Before You Begin
Before you begin, obtain an API Key from Zuper. Zuper authenticates with an API key only — no separate secret is required.
To create the key in the Zuper portal:
Log in to the Zuper portal.
Go to Settings > Account Settings > API Keys.
To use an existing key, click View Key for the API key name. To create a new one, click New API Key, type an API Key Name, and click Create.
Copy the key. You will need it to configure your subscription.
You will also need your API URL, which is specific to your Zuper region. If you do not know it, call the Zuper Config API at https://accounts.zuperpro.com/api/config with your company login name and use the returned dc_api_url value with /api appended (for example, https://us-west-1c.zuperpro.com/api).
Installation Instructions for Integration Setup
Go to Subscriptions Management > Subscriptions and click Search Certified Integration Marketplace and Subscribe.
Click the Zuper integration tile.
3. On the Subscription Detail page, click Subscribe. 4. Enter a name for the subscription and select a version. Use any relevant, unique name for the company where the subscription is created. - Format: [Product Name] - [Environment/Purpose] - Example: Zuper - Production 5. Select Create Default Mappings (recommended). Leave this unchecked only if you intend to build all mappings from scratch yourself.
6. Enter the API Key you saved from Zuper. 7. Enter the API URL for your Zuper region. - Test/Sandbox: https://us-west-1c.zuperpro.com/api 8. Enter the API Throttle Limit, which controls how many requests can run at once so a single integration does not overwhelm the system. - Recommended values: Initial Setup: 5 · Ongoing Operations: 500 · High Volume: 500 9. Enter the API Throttle Seconds, the time window over which the throttle limit is measured. - Default: 60 seconds 10. Enter the number of Concurrent Connections, the maximum number of simultaneous connections to Zuper. - Default: 10 11. Enter the number of Concurrent Batch Executions, the maximum number of batch executions that run at once. - Default: 10 12. Click Apply to save the settings.
Post-Installation Verification
After completing the installation, verify it with these checks:
Data Sync Test
Run a sample capture into iPaaS.com (for example, Manual Sync a Zuper customer).
Run a sample transfer from iPaaS.com to Zuper (for example, Manual Sync a customer to Zuper).
Functionality Test
Run an end-to-end transfer for a representative record.
Confirm field mappings populate as expected.
Review the integration logs in iPaaS.com.
Common Issues and Solutions
Invalid API URL
Description: Using a fixed URL instead of your region-specific one.
Resolution: Call the Zuper Config API (https://accounts.zuperpro.com/api/config) with your company login name to get the correct dc_api_url, then append /api.
Authentication Failures
Description: API requests return 401 Unauthorized.
Resolution: Confirm the API Key entered in the subscription matches a valid, active key in your Zuper account, and that the API URL is correct for your region.
Insufficient Permissions
Description: A record cannot be created or updated in Zuper.
Resolution: Ensure the Zuper account tied to the API key has the necessary role (for example, Admin, Manager, or Dispatcher) for the records being synchronized.
Invalid or Missing IDs
Description: A transfer fails because a referenced record (customer, location, product) does not exist in Zuper.
Resolution: Confirm the referenced record exists in Zuper before the transfer, or map a value that resolves to an existing record.
Support and Troubleshooting
Click the Help button on any iPaaS.com page to contact Support or search the documentation.
Documentation: Search the documentation at the top of this article.
Support Portal: Click the Help and Support button at the lower-right of the window.
Contact: Contact iPaaS.com.