Skip to main content
All CollectionsIntegrationsCustom Integrations
Setting up a custom Validator integration
Setting up a custom Validator integration

Instructions how to set up a custom validator integration

Felix Higgs avatar
Written by Felix Higgs
Updated over a month ago

A Custom Validator allows Knak Users to quickly test Knak Asset content with your own content testing service, providing seamless integration of your own business rules for content validation into the Knak Asset creation process.

Custom Validator API

Before connecting your own service with Knak, ensure that your service supports the necessary endpoints. Details of the required endpoints and data schema can be found in the API specification at https://enterprise.knak.io/docs/custom-validator-api

Connecting your Custom Validator

Navigate to Admin → Integrations → Platforms, scroll down to the “Content Testing” section and click on the “Custom Validator” tile.

The “Auth Header Name” and “Auth Header Value” allow you to define the Authorization mechanism that your service prefers.

The “Platform Format” option determines which Marketing Automation Platform (if any) the Asset content for testing will be optimized for.

For the “endpoint URL” field, enter the URL of your service at the API root: for example, if your service implements the “Validate” action at https://yourService.com/yourApi/v1/validate, enter https://yourService.com/yourApi in this field.

Managing your integration

Now that your integration is set up, you can view its configuration, edit it, or delete it from the "My Platform Connection" list on the Integrations page.

If you need to connect a new integration – or re-add a previously deleted one – you can do so by scrolling down to the "All Platforms" section and clicking Connect or Add Another Connection on the relevant platform tile.

Using your Custom Validator

Users can initiate your Validation process for an Asset as shown in the screenshot below. The Validator will appear with the name as set in the integration setup. The latest version of the current Asset being edited will be sent to the validation service.

Need more help? Contact support via live chat within Knak using the chat bubble in the bottom right corner or email support@knak.com.

Did this answer your question?