To send a webhook to another app when a conversion is recorded in ClickMagick, just follow these steps …
1.
Get your Endpoint URL from the service you want ClickMagick to send the webhook.
2.
Go to your Project Dashboard, select Webhooksin the Tools menu, then Outgoing Webhooks. Then click “Add Endpoint” button.
3.
Choose the parameters you want to trigger the webhook, select the Conversion Type, and enter your service’s Endpoint URL, including any ClickMagick tokens, to send back the information you’re interested in. These tokens are described in the next section.
4.
When you send clicks to your landing page using your UTM-powered link, you can also send a unique identifier that ClickMagick will return in your webhook. Simply pass the unique value in the cmc_tid parameter of your link:
The unique value can be anything and is usually generated automatically by your traffic source—it will generally be a unique number or sometimes an email address. If you look up “postback” or “webhook” in the knowledge base of your traffic source, you should find instructions on generating this optional value.
Which ClickMagick tokens are available for use in the Endpoint URL?
If you use any of the tokens below in an Endpoint URL, they will be replaced with actual values when the webhook request is sent. For example, [cmc_amt] would be replaced with the actual amount for a sale.
The [cmc_vid] token is replaced with the Visitor ID.
The [cmc_tid] token returns the cmc_tid URL parameter value that was sent with the click.
The [cmc_project] token returns the name of your Project.
The [cmc_ref] token returns the ref value of your Action, Engagement, or Sale Conversion.
The [cmc_amt] token returns the sale amount of your Sales Conversions.
The [utm_] tokens return the value of UTM parameters.
The [s1] through [s5] tokens return the values in the s1 through s5 parameters in your Postback URL. You can use these values to send special information from your Postback URL to your Webhook's Endpoint URL.
The [firstname] and other visitor info parameters return specific visitor info values.
The [gclid] and other ad network Click ID parameters return the corresponding Click ID value.
The [timestamp] token is replaced with the time of the conversion in UTC format: 2025-01-27 22:55:19+0000
Can you show me an example?
With a Project, you will generally use the [cmc_tid] and [cmc_amt] tokens in your webhooks.
The [cmc_tid] token represents the Click ID or Transaction ID that was initially sent to ClickMagick by the original service (typically a traffic source), and the [cmc_amt] token represents the amount of a sale that was made.
For example, if you were using MGID and they told you to use this Endpoint URL with their service when a sale is made ...