Home
What is June?
Quick start

SDK Guides

Browser
React
Node.js
Python
Ruby
HTTP API
Log in

HTTP API

Instant insights with HTTP requests from any app

Configuring

Now, you must send the June SDK with a valid API key as part of the Authorization header, which you can get from your June workspace.

1
curl https://api.june.so/sdk/identify \
2
-H "Content-Type: application/json" \
3
-H "Authorization: Basic {YOUR_WRITE_KEY}" \
4
--data '{"userId": "USER_ID","traits": {"email": "test@example.com"},"timestamp": "2012-12-02T00:30:08.276Z"}'

Identifying users

You can use the identify endpoint to identify your users. Replace USER_ID with the unique identifier for the user in your database.

1
POST https://api.june.so/sdk/identify
1
// Send an identify call
2
{
3
"userId": "USER_ID",
4
"traits": {
5
"email": "test@example.com"
6
},
7
"timestamp": "2012-12-02T00:30:08.276Z"
8
}

Identifying companies (optional)

You can use the group endpoint to identify your companies. Replace GROUP_ID and USER_ID with the unique identifier for the company and user in your database.

1
POST https://api.june.so/sdk/group
1
{
2
"userId": "USER_ID",
3
"groupId": "GROUP_ID",
4
"traits": {
5
"name": "Acme Inc"
6
},
7
"timestamp": "2012-12-02T00:31:38.208Z"
8
}

Send track events

In order to track user behaviour, you can use the track endpoint.

Note: If you're identifying companies, you should pass the groupId in the track context, as shown in the example below. Replace GROUP_ID and USER_ID with the unique identifier for the company and user in your database.

1
POST https://api.june.so/sdk/track
1
// Send a track event
2
{
3
"userId": "USER_ID",
4
"event": "Created Account",
5
"properties": {
6
"plan": "Pro"
7
},
8
"context": {
9
"groupId": "GROUP_ID"
10
},
11
"timestamp": "2012-12-02T00:30:12.984Z"
12
}