Overview
This article catalogs the error messages you may encounter when synchronizing data between Podium and iPaaS.com, grouped by the mapping collection flow that produces them. Each entry explains what causes the error and how to resolve it. Errors appear in Dashboard / Integration Monitoring / Error Logs.
Supported Flows
Connection and Authentication
Add Podium Contact TO iPaaS.com
Add/Update Podium Contact FROM iPaaS.com
Add Podium Invoice TO iPaaS.com
Add Podium Invoice FROM iPaaS.com
Webhook Configuration
Connection and Authentication
Missing Client Credentials
Error message: Authentication failed: Missing ClientId or ClientSecret in the integration version custom fields. Unable to generate a new access token.
Description: The integration could not authenticate with Podium because the OAuth client credentials are not configured for this integration version.
Resolution: Contact iPaaS.com Support at support@ipaas.com. These credentials are configured by iPaaS.com and are not set by the subscriber.
No Valid Refresh Token
Error message: Authentication failed: No valid refresh token found. Unable to generate a new access token.
Description: The integration does not have a valid Podium refresh token, so it cannot obtain a new access token. This usually means the Podium connection has not been completed or has been revoked.
Resolution: Reconnect the Podium account from the subscription's connection settings. If the problem continues, contact iPaaS.com Support at support@ipaas.com.
Unable to Refresh Access Token
Error message: Authentication failed: Unable to retrieve a new access token using the provided refresh token.
Description: Podium rejected the stored refresh token when the integration tried to obtain a new access token, typically because the authorization was revoked or expired in Podium.
Resolution: Reconnect the Podium account to re-authorize the integration. If the problem continues, contact iPaaS.com Support at support@ipaas.com.
Add Podium Contact TO iPaaS.com
Duplicate Customer Link
Error message: Unable to link to the existing iPaaS.com Customer using the email address. This may result in duplicate customer records.
Description: While transferring a Podium contact, the integration found an existing iPaaS.com Customer with the same email address but could not record the external-ID link to it, so a duplicate Customer may be created.
Resolution: Review the affected Customer records in iPaaS.com for duplicates. If duplicates appear, contact iPaaS.com Support at support@ipaas.com.
Add/Update Podium Contact FROM iPaaS.com
Contact Not Created
Error message: Could not create customer in Podium.
Description: Podium rejected the request to create the contact. This commonly occurs when the contact does not have the values Podium needs to create a record, such as an email address or phone number.
Resolution: Confirm the iPaaS.com Customer has an email address or phone number and that the Locations mapping references a valid Podium location, then re-run the transfer.
Contact Not Updated
Error message: Could not update customer in Podium.
Description: Podium rejected the request to update the contact.
Resolution: Confirm the iPaaS.com Customer still resolves to a valid Podium contact (by email address or phone number) and re-run the transfer. If the problem continues, contact iPaaS.com Support at support@ipaas.com.
Add Podium Invoice TO iPaaS.com
Location Preset Name Not Found
Error message: Cannot create Transaction in iPaaS.com because the Location preset name does not exist in Podium.
Description: The Location subscription setting names a Podium location that does not exist in the connected Podium account, so the invoice could not be retrieved.
Resolution: Update the Location setting to a location name (or location Uid) that exists in Podium. See the Podium Connections and Settings article for where to configure it.
Location Preset Empty
Error message: Cannot create Transaction in iPaaS.com because the Location preset is empty. Provide a location in this preset.
Description: A location is required to retrieve the invoice from Podium, but the Location subscription setting is empty.
Resolution: Enter a valid Podium location name (or location Uid) in the Location setting. See the Podium Connections and Settings article.
Duplicate Transaction Link
Error message: Unable to link to the existing iPaaS.com Transaction using the transaction number. This may result in duplicate transaction records.
Description: While transferring a Podium invoice, the integration found an existing iPaaS.com Transaction with the same transaction number but could not record the external-ID link to it, so a duplicate Transaction may be created.
Resolution: Review the affected Transaction records in iPaaS.com for duplicates. If duplicates appear, contact iPaaS.com Support at support@ipaas.com.
Add Podium Invoice FROM iPaaS.com
Line Item Total Too Low
Error message: The total amount of all line items must be greater than 50.
Description: Podium requires the combined total of an invoice's line items to be greater than 50 cents. The invoice was not sent because its line items total 50 cents or less. This validation is part of the Add Podium Invoice Line FROM iPaaS.com collection filter and can be adjusted by editing that filter in iPaaS.com.
Resolution: Ensure invoices sent to Podium have line items totaling more than 50 cents. Subscribers or their MiSP can adjust the minimum by editing the collection's mapping filter if Podium's requirement changes.
Customer Prerequisite Failed
Error message: Unable to create the customer in Podium. This will prevent the transfer of the invoice.
Description: Before sending an invoice, the integration ensures the invoice's customer exists in Podium. The customer could not be created, so the invoice was not sent.
Resolution: Confirm the iPaaS.com Customer linked to the Transaction has the values Podium needs (an email address or phone number) and that the Locations mapping references a valid Podium location, then re-run the transfer.
Invoice Not Created
Error message: Could not create the iPaaS.com Transaction as an Invoice in Podium.
Description: Podium rejected the request to create the invoice. This can occur when a required value is missing, such as the Podium location or a valid customer.
Resolution: Confirm the Transaction's locationUid custom field holds a valid Podium location identifier and that the Transaction is linked to a customer, then re-run the transfer.
Webhook Configuration
Webhook Location Not Specified
Error message: At least one field must be specified: Webhook Subscription (Organization / Location) or Location.
Description: The integration could not create the Podium webhook subscription because neither the Webhook Subscription To Organization Or Location setting nor the Location setting was provided.
Resolution: Set the Webhook Subscription To Organization Or Location setting (to Organization or Location), or set the Location setting to a specific Podium location. See the Podium Installation Instructions for the webhook setup.