Bulk Create Client Events

post https://a.klaviyo.com/client/event-bulk-create/

Create new events to track a profile's activity.

This endpoint is specifically designed to be called from publicly-browseable, client-side environments only and requires a public API key (site ID). Never use a private API key with our client-side endpoints.

To create events from server-side applications, please use POST /api/event-bulk-create-jobs.

Accepts a maximum of 1000 events per request.

Rate limits:
Burst: 10/s
Steady: 150/m

Scopes:
events:write

Responses

202

Success

Language


xxxxxxxxxx
45
1
curl --request POST \
2
     --url 'https://a.klaviyo.com/client/event-bulk-create/?company_id=PUBLIC_API_KEY' \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --header 'revision: 2024-06-15' \
6
     --data '
7
{
8
  "data": {
9
    "type": "event-bulk-create",
10
    "attributes": {
11
      "profile": {
12
        "data": {
13
          "type": "profile",
14
          "attributes": {
15
            "email": "sarah.mason@klaviyo-demo.com",
16
            "phone_number": "+15005550006",
17
            "first_name": "Sarah",
18
            "last_name": "Mason",
19
            "organization": "Example Corporation",
20
            "title": "Regional Manager",
21
            "image": "https://images.pexels.com/photos/3760854/pexels-photo-3760854.jpeg",
22
            "location": {
23
              "address1": "89 E 42nd St",
24
              "address2": "1st floor",
25
              "city": "New York",
26
              "country": "United States",
27
              "latitude": "40.7128",
28
              "longitude": "74.0060",
29
              "region": "NY",


xxxxxxxxxx
14
 
1
{
2
  "errors": [
3
    {
4
      "id": "string",
5
      "code": "string",
6
      "title": "string",
7
      "detail": "string",
8
      "source": {
9
        "pointer": "string",
10
        "parameter": "string"
11
      }
12
    }
13
  ]
14
}

4XXClient Error

5XXServer Error