When does this error occur?
After registering your system on the Integrator Portal, you’ll be prompted to submit your API credentials, which include:
- Username and Password – for authenticating API requests
- Host, Port, and Path – indicating the location of your system's API
If you receive a 409 Conflict error during this step, it means that some of the information you’ve entered is not unique within our system.
What causes the 409 error?
This error typically indicates a conflict with existing credentials already in use by another integration or user. Common reasons include:
- The host has already been registered by another integration (e.g., https://api.example.com is already in use)
- The Integration Name is already in use.
- The username has already been used by another integration or user
- A combination of host, port, and path is not unique
- A subdomain (e.g., test.example.com) and the main domain (e.g., example.com) may be treated as conflicting or overlapping if the system considers them related
How to resolve the issue:
Please remember that any system should be unique for your company and that you will have a testing environment to troubleshoot any change.
For other situations:
- Try using a different host (subdomain or path), if you manage multiple environments
- Use a unique username that hasn’t been used previously
- Coordinate with your team to verify that credentials haven’t already been submitted for this integration
- If you're re-submitting or migrating, you may need to delete or update old test configurations
Still stuck?
If you're unable to resolve the conflict, please contact our support team with the details of the credentials you’re trying to register. We’ll help you identify the issue and how to proceed.