{
  "opencollection": "1.0.0",
  "info": {
    "name": "Klaviyo Accounts Events API",
    "version": "2026-04-15"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "Authorization",
      "value": "{{Authorization}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Events",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get Events",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/events",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "fields[event]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "fields[metric]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "fields[profile]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "filter",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering<br>Allowed field(s)/operator(s):<br>`metric_id`: `equals`<br>`profile_id`: `equals`<br>`profile`: `has`<br>`datetime`: `greater-or-equal`, `greater-than`, `less-or-equal`, `less-than`<br>`timestamp`: `greater-or-equal`, `greater-than`, `less-or-equal`, `less-than`"
              },
              {
                "name": "include",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
              },
              {
                "name": "page[cursor]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
              },
              {
                "name": "page[size]",
                "value": "",
                "type": "query",
                "description": "Default: 200. Min: 1. Max: 1000."
              },
              {
                "name": "sort",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting"
              }
            ]
          },
          "docs": "Get all events in an account\n\nRequests can be sorted by the following fields:\n`datetime`, `timestamp`\n\n[Custom metrics](https://developers.klaviyo.com/en/reference/custom_metrics_api_overview) are not supported in the `metric_id` filter.\n\nReturns a maximum of 200 events per page.<br><br>*Rate limits*:<br>Burst: `350/s`<br>Steady: `3500/m`\n\n**Scopes:**\n`events:read`"
        },
        {
          "info": {
            "name": "Create Event",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://a.klaviyo.com/api/events",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a new event to track a profile's activity.\n\nNote that this endpoint allows you to create a new profile or update an existing profile's properties.\n\nAt a minimum, profile and metric objects should include at least one profile identifier (e.g., `id`, `email`, or `phone_number`) and the metric `name`, respectively.\n\nSuccessful response indicates that the event was validated and submitted for processing, but does not guarantee that processing is complete.<br><br>*Rate limits*:<br>Burst: `350/"
        },
        {
          "info": {
            "name": "Get Event",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/events/:id",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "ID of the event"
              },
              {
                "name": "fields[event]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "fields[metric]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "fields[profile]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "include",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
              }
            ]
          },
          "docs": "Get an event with the given event ID.<br><br>*Rate limits*:<br>Burst: `10/s`<br>Steady: `150/m`\n\n**Scopes:**\n`events:read`"
        },
        {
          "info": {
            "name": "Bulk Create Events",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://a.klaviyo.com/api/event-bulk-create-jobs",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a batch of events for one or more profiles.\n\nNote that this endpoint allows you to create new profiles or update existing profile properties.\n\nAt a minimum, profile and metric objects should include at least one profile identifier (e.g., `id`, `email`, or `phone_number`) and the metric `name`, respectively.\n\nAccepts up to 1,000 events per request. The maximum allowed payload size is 5MB. A single string cannot exceed 100KB.<br><br>*Rate limits*:<br>Burst: `10/s`<br>Steady: `150/m`\n\n**Scop"
        },
        {
          "info": {
            "name": "Get Metric for Event",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/events/:id/metric",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "ID of the event"
              },
              {
                "name": "fields[metric]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              }
            ]
          },
          "docs": "Get the metric for an event with the given event ID.<br><br>*Rate limits*:<br>Burst: `350/s`<br>Steady: `3500/m`\n\n**Scopes:**\n`events:read`\n`metrics:read`"
        },
        {
          "info": {
            "name": "Get Metric ID for Event",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/events/:id/relationships/metric",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "ID of the event"
              }
            ]
          },
          "docs": "Get a list of related Metrics for an Event<br><br>*Rate limits*:<br>Burst: `350/s`<br>Steady: `3500/m`\n\n**Scopes:**\n`events:read`\n`metrics:read`"
        },
        {
          "info": {
            "name": "Get Profile for Event",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/events/:id/profile",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "ID of the event"
              },
              {
                "name": "additional-fields[profile]",
                "value": "",
                "type": "query",
                "description": "Request additional fields not included by default in the response. Supported values: 'subscriptions', 'predictive_analytics'"
              },
              {
                "name": "fields[profile]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              }
            ]
          },
          "docs": "Get the profile associated with an event with the given event ID.<br><br>*Rate limits*:<br>Burst: `350/s`<br>Steady: `3500/m`\n\n**Scopes:**\n`events:read`\n`profiles:read`"
        },
        {
          "info": {
            "name": "Get Profile ID for Event",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/events/:id/relationships/profile",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "ID of the event"
              }
            ]
          },
          "docs": "Get profile [relationships](https://developers.klaviyo.com/en/reference/api_overview#relationships) for an event with the given event ID.<br><br>*Rate limits*:<br>Burst: `350/s`<br>Steady: `3500/m`\n\n**Scopes:**\n`events:read`\n`profiles:read`"
        }
      ]
    }
  ],
  "bundled": true
}