Quickstart
Get up and running with the Pointeron API in minutes. This guide walks you through creating an API key, making your first request, pushing location data, and setting up a webhook.
You will need an API key to authenticate requests. Navigate to Settings » API Keys in the Pointeron dashboard to generate one.
Step 1: Get your API key
- Sign in to the Pointeron dashboard.
- Go to Settings » API Keys.
- Click Create API Key, give it a name, and select the scopes you need.
- Copy the key immediately -- it is only shown once. Keys start with
sk_live_for production orsk_test_for testing.
Step 2: List your assets
Make your first API call by listing the assets in your organization.
curl https://api.pointeron.com/v2/assets \
-H "Authorization: Bearer ${POINTERON_ACCESS_TOKEN}"
You should receive a JSON response containing your assets. If you do not have any assets yet, the data array will be empty.
Step 3: Create an asset
Create a new tracked asset by sending a POST request.
curl -X POST https://api.pointeron.com/v2/assets \
-H "Authorization: Bearer ${POINTERON_ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d '{
"name": "Delivery Van 01",
"type": "vehicle",
"metadata": {
"plate": "LJ-AB-123",
"driver": "John"
}
}'
Step 4: Push a location point
Send a location update for a device. The location is automatically associated with the device's assigned asset.
curl -X POST https://api.pointeron.com/v2/locations \
-H "Authorization: Bearer ${POINTERON_ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d '{
"device_id": "xgQQXg3hrtjh7AvZ",
"latitude": 46.0569,
"longitude": 14.5058,
"altitude": 295.0,
"speed": 45.2,
"heading": 180,
"accuracy": 5.0,
"recorded_at": "2026-03-14T10:30:00Z"
}'
Step 5: Set up a webhook
Register a webhook to receive real-time notifications when events occur in your organization.
curl -X POST https://api.pointeron.com/v2/webhooks \
-H "Authorization: Bearer ${POINTERON_ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-app.com/webhooks/pointeron",
"events": ["asset.created", "asset.updated", "geofence.entered", "geofence.exited"],
"description": "Production webhook"
}'
Save the secret returned in the response. You will need it to verify webhook signatures.
What's next?
You are now set up and ready to build with the Pointeron API. Here are some helpful next steps: