THIS WEEK The Essential Guide to URL Management Read this week's article →
All API references

Conversions API

Record business outcomes against a short link without double-counting retries.

POST /api/v1/conversions GoTo.now API key
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.


Return to all API references