Authentication
Use https://goto.now and send Authorization: Bearer gtn_YOUR_KEY. Keep the key in server-side secrets, never browser code, a URL, or a public repository.
Record an outcome
curl https://goto.now/api/v1/conversions \
-H "Authorization: Bearer gtn_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"shortCode":"launch","event":"purchase","externalId":"order_123","value":49,"currency":"USD","metadata":{"plan":"starter"}}'
shortCode is required and must belong to the account. event defaults to conversion; use a stable name such as purchase, signup, or booking. value, a three-letter currency, and a JSON metadata object are optional.
Send a stable externalId for every real-world event. Repeating it with the same API key returns the original event with duplicate: true instead of recording it twice. New events return HTTP 201; idempotent replays return HTTP 200.