This tool is provided for developers who wish to create a new integration for the LeadConduit platform. After asking a few simple questions, it generates the code and tests necessary to integrate a third party system with LeadConduit. It is intended that the generated code be customized to account for the specifics of integrating with a particular system.
You must also have the Yeoman tool and this generator installed:
npm install -g yonpm install -g generator-leadconduit-integration
Finally, create a directory for your new integration. Use the
leadconduit-integration-* naming convention, where
* is the name of the service you are integrating with:
Once those steps are done, you're ready to generate a new LeadConduit integration.
We strongly recommend creating a public GitHub repository for your new integration before you run the generator. Doing this step now is optional, but you'll need to do it eventually and it makes the generator a little smarter. Follow the online instructions before you generate your integration.
In the directory for your integration, run the generator using
cd leadconduit-integration-foobaryo leadconduit-integration
After answering a short series of questions, your integration will be generated. The integration code can be found
src/ directory and the tests for your code can be found in the
The generator created some tests for you based on the answers you gave. You can run the tests as follows:
When you make changes to the code, you will also need to change the tests. We will not allow integrations on to the platform which have broken or inadequate tests, so make sure you give due attention to the tests.
If you're trying to write an integration but are running into any sort of trouble, we're always here to help. Send an email to our Support Team and we'll reply right away. When asking for help, it's best if the integration is committed to GitHub so that we can look at it, pull it down, and run it as we're helping you work through your questions.
Once you have finished your integration and are satisfied that you have excellent test coverage, send an email to our Support Team to let use know that you'd like to include your integration on the LeadConduit platform.
Generally speaking there are three steps that must be taken to take your integration live:
We use Semantic Versioning and you should too. But if you don't know how, don't worry. We'll help ensure that your package version makes sense before we include it on the platform or before we allow updates to your integration.