Conexus Docs

Appearance

Conexus — Konnektive Plugin Setup ​

This guide walks you through creating a Conexus plugin for Konnektive and configuring Konnektive to send order postbacks to Conexus.

Prerequisites ​

  • You have access to your Conexus account and can create plugin instances.
  • You have admin access to Konnektive (to create/export webhook profiles).
  • Keep a secret key ready for webhook authentication.

Steps ​

  1. Enter a name for your plugin in Conexus.
  2. Enter a secret key.
    • The secret is used to authenticate webhook requests.
    • Conexus will expose a webhook URL — add the secret to the Conexus webhook URL as a query parameter (example below).
  3. Select a campaign — this tells Conexus which campaign to use to fetch SKUs.
  4. Import Non-Existing SKUs
    • If enabled, SKUs that do not exist in Conexus will be imported.
    • These SKUs will not be linked to products and will be imported only as plain text.
  5. Click the Create button to finish creating the plugin.
  6. You will see the newly created plugin in your existing installed plugins table.
  7. Click the new plugin entry (the row that shows the Konnektive plugin id / instance).
  8. At the bottom you will see the Webhook URL; click the copy icon to copy the webhook URL.
    • The copied URL will include query parameters such as organizationId, pluginInstanceId.
    • Example copied URL (illustrative):
      https://api.tryconexus.com/api/v1/plugins/webhooks/konnektive?organizationId=org-123&pluginInstanceId=inst-456
  9. Open Konnektive and go to Admin → Export.
  10. In Export Webhook Profiles click the plus icon to create a new profile.
  11. Choose a profile name and choose Export Type: Postback.
  12. After creation the profile will appear in your Export Webhook Profiles list.
  13. Click the pencil (edit) icon next to the profile you just created.
  14. In the Postback URL section paste the Conexus URL you copied from step 8 — but see step 16–17 for modifications.
  15. In the Field Mapping section add the following mapping (JSON):
json
{
  "country": "[country]",
  "product1_qty": "[product1_qty]",
  "orderId": "[orderId]",
  "state": "[state]",
  "product1_sku": "[product1_sku]",
  "shipAddress2": "[shipAddress2]",
  "address2": "[address2]",
  "firstName": "[firstName]",
  "shipState": "[shipState]",
  "phoneNumber": "[phoneNumber]",
  "customerType": "[customerType]",
  "shipCountry": "[shipCountry]",
  "organizationId": "your-org-id",
  "product1_name": "[product1_name]",
  "orderStatus": "[orderStatus]",
  "postalCode": "[postalCode]",
  "product1_price": "[product1_price]",
  "shipAddress1": "[shipAddress1]",
  "city": "[city]",
  "lastName": "[lastName]",
  "shipCity": "[shipCity]",
  "address1": "[address1]",
  "emailAddress": "[emailAddress]",
  "shipPostalCode": "[shipPostalCode]",
  "pluginInstanceId": "your-plugin-instance-id"
}
  1. Extract organizationId from the Conexus URL you copied:
  • Copy the organization id value and place it in the organizationId field inside the JSON mapping above.
  • Remove the organizationId key and value from the Postback URL query string before saving the profile in Konnektive.
  1. Extract pluginInstanceId from the Conexus URL:
  • Copy the plugin instance id value and place it in the pluginInstanceId field in the JSON mapping.
  • Remove the pluginInstanceId key and value from the Postback URL query string as well.
  1. Click Update to save the Export Webhook Profile in Konnektive.
  2. From now on, new orders created in Konnektive will be sent to Conexus via the configured postback.
  3. Troubleshooting: If you get the error
    • Invalid Postback URL: cannot contain a question mark it means your Postback URL still contains query parameters (for example organizationId or pluginInstanceId or secret). Remove all query parameters so the Postback URL looks like this example (no ? or query string): https://api.tryconexus.com/api/v1/plugins/webhooks/konnektive

Summary / Example workflow ​

  • Copy the Conexus webhook URL.
  • Pull the organizationId and pluginInstanceId values out of the copied URL and put them into the JSON mapping fields organizationId and pluginInstanceId.
  • Remove those parameters from the copied URL (so the URL has no ?).
  • Paste the cleaned URL into Konnektive Postback URL.
  • Save the field mapping JSON in Konnektive and update the webhook profile.

Notes ​

  • Do not leave organizationId or pluginInstanceId in the Postback URL query string — Konnektive rejects URLs with ?.
  • Keep your secret key confidential. You may include it as a query parameter in Conexus when Conexus generates the final webhook URL but do not leave the secret exposed elsewhere.
  • Non-existing SKUs imported from Konnektive will be plain text entries until they are linked to Conexus products.