How do I record conversions in ClickMagick via a webhook?
To send conversions from another system into ClickMagick, just send the conversion data to the appropriate Incoming Webhook Endpoint URL based on the type of conversion you want to record.
There’s just one required parameter, and six optional parameters you can provide …
s1 – This required value should be the email address or Visitor ID for the visitor. This will normally be supplied via a token provided by the system sending the webhook e.g. s1=[email]
If you don’t have the email address, you can get the Visitor ID from the first-party cookie that ClickMagick sets on your domain, or via the [cmc_vid] token which is available on any page with your Click Tracking code.
ref – An optional “reference” value associated with the conversion. While this is technically optional, you should always provide a unique ref value for each type of conversion that you track e.g. ref=opt-in or ref=sale
amt – The optional amount for a sales conversion e.g. amt=100.00
cmc_currency – An optional 3-character currency code to go with the amount e.g. &cmc_currency=USD
This isn’t normally needed as most users view their stats in ClickMagick in the currency their business receives money in, but if this value is provided the amount will be converted to the currency of your corresponding Project.
cmc_project – An optional Project name if you want ClickMagick to process conversions even when the email or Visitor ID is not found. If you supply a valid Project name e.g. &cmc_project=my+project we will automatically create an organic click, process the conversion, and attribute it to that new Visitor ID.
cmc_cogs – An optional COGS amount to attach to a sale (sales only, obviously) e.g. &cmc_cogs=25.00
timestamp – Optional timestamp of the conversion, otherwise it defaults to “now” e.g. ×tamp=20250212162125
Timestamps can be in any of the following formats:
YYYYMMDDHHMMSS
UTC 0
YYYY-MM-DD HH:MM:SS
UTC 0
YYYY-MM-DD HH:MM:SSZ
UTC 0
YYYY-MM-DD HH:MM:SS+HH:MM
+HH:MM time zone
YYYY-MM-DD HH:MM:SS-HH:MM
-HH:MM time zone
YYYY-MM-DDTHH:MM:SS
UTC 0
YYYY-MM-DDTHH:MM:SSZ
UTC 0
YYYY-MM-DDTHH:MM:SS+HH:MM
+HH:MM time zone
YYYY-MM-DDTHH:MM:SS-HH:MM
-HH:MM time zone
Article 793 Last updated: 10/16/2025 10:11:00 AM https://www.clickmagick.com/kb/?article=793