Skip to content

Events API

Create events in bulk

POSThttps://email.growthdept.ai/api/event-bulk-create-jobs

Queues events for up to 1000 events across many profiles. Profiles and metrics are created as needed; events whose unique_id was already recorded are dropped. Answers 202 with no body.

The request body can be up to 5 MB.

Rate limits

Burst: 10/s

Steady: 150/m

Tier M. See rate limits for how requests are counted.

Scopes

events:write

Operation id

bulk_create_events The same operation as in Klaviyo's API. OpenAPI document

Body

Send application/vnd.api+json or application/json.

object

  • dataobjectrequired

    data: 2 fields
    • typestringrequired

      event-bulk-create-job
    • attributesobjectrequired

      attributes: 1 field
      • events-bulk-createobjectrequired

        events-bulk-create: 1 field
        • dataarray of objectsrequired

          data: 2 fields
          • typestringrequired

            event-bulk-create
          • attributesobjectrequired

            attributes: 3 fields
            • backfillbooleancan be null

            • profileobjectrequired

              profile: 1 field
              • dataobjectrequired

            • eventsobjectrequired

              events: 1 field
              • dataarray of objectsrequired

Edit the example. The code samples use what you type here.

Headers

stringrequireddefault 2026-10-15

API revision, YYYY-MM-DD. This server implements 2026-10-15.

Revisions guide

Responses

202Success

No body.

4XXClient error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject

See status codes for each code.

5XXServer error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject