Create custom goals

POST https://datafa.st/api/v1/goals

Create a custom goal for a specific visitor. Requires Bearer Token authentication.

Request body

Send a JSON object with the following fields:

visitorId (String, required): The unique ID of the visitor. It is stored in the visitor's browser cookies as datafast_visitor_id, making it accessible in your backend API endpoints.
name (String, required): Name for the goal (lowercase letters, numbers, underscores, max 32 chars). Spaces are converted to underscores.
description (String, optional): Description for the event.

A visitor needs to have at least one pageview before the goal can be created.

Response

Success (200 OK): Returns a confirmation message and the ID of the created event.
Errors: See API Introduction. A 400 occurs if the visitor is a bot. A 404 occurs if the visitor has no prior pageviews.

Something missing? Suggest features ✍️

// Your backend API endpoint const handler = async (req, res) => { const visitorId = req.cookies.datafast_visitor_id; try { const response = await fetch("https://datafa.st/api/v1/goals", { method: "POST", headers: { Authorization: `Bearer ${DATAFAST_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ visitorId: visitorId, name: "newsletter_signup", description: "Sign up for the newsletter", // optional }), }); const result = await response.json(); console.log("Goal sent to DataFast:", result); res.status(200).send("Goal tracked"); } catch (error) { console.error("Error sending goal to DataFast:", error); res.status(500).send("Failed to track goal"); } };