Troubleshooting Third-Party Integrations
Postcards integrates with several third-party services, such as email marketing platforms and CRM tools. While the system is designed to work seamlessly, integration issues can sometimes occur due to limitations, outages, or permission settings on the third-party side.
This article outlines how to identify and resolve common integration problems, and when it may be necessary to contact external support.
Common Integration Issues
- Authentication failures, such as invalid credentials or expired tokens
- Export or sync errors, where the template fails to appear in the connected service
- Permission or access restrictions in the third-party account
- API rate limits or usage restrictions based on the third-party plan
Troubleshooting Steps
1. Reconnect the Integration
Go to the Integrations section in your Postcards account. Disconnect the current connection, then reauthorize using the correct login credentials. This often resolves expired tokens or outdated permissions.
2. Confirm Account Permissions
Make sure the connected third-party account has the required permissions to access APIs, templates, or marketing tools. Limited-access or restricted roles may prevent successful integration.
3. Check for Errors in Export Logs
If a sync or export fails, Postcards may display a message indicating the nature of the issue. Reviewing this message can help determine whether the problem originates from the third-party platform.
4. Review Service Status and API Limits
Consult the status page or documentation of the third-party platform to check for ongoing outages or maintenance windows. If you're on a limited/free plan, confirm you haven’t exceeded API usage limits.
When to Contact the Third-Party Support Team
If you've confirmed the setup is correct on your end and the issue persists, it's appropriate to reach out to the support team of the third-party service. Examples of when to do this include:
- Authorization requests being rejected despite valid credentials
- Unexpected API errors originating from the third-party system
- Platform-side downtime or known service issues
Be prepared to share any error messages or timestamps to assist their investigation.
When to Contact Postcards Support
If you’re unsure whether the issue lies with Postcards or the third-party provider, contact our support team with the following information:
- The name of the integration you're using
- A brief description of the issue
- Any error messages received
Steps you've already tried
We can help identify whether the issue is internal or needs to be escalated externally.