LOloops
Events

Send an event

Changed on

Send events to trigger workflows.

post/v1/events/send

Request

  • Base URL
    https://app.loops.so/api
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring

Include a unique ID for this request (maximum 100 characters) to avoid duplicate emails.

The value should be a string of up to 100 characters and should be unique for each request. We recommend using V4 UUIDs or some other method with enough guaranteed entropy to avoid collisions during a 24 hour window.

This endpoint will return a 409 Conflict response if the idempotency key has been used in the previous 24 hours.

Request body

OR

Example request

{
  "email": "alex@company.com",
  "userId": "usr_7f8e9d0c1b2a",
  "eventName": "signup",
  "eventProperties": {
    "planName": "Pro",
    "importDate": "2021-01-01"
  },
  "mailingLists": {
    "cm06f5v0e45nf0ml5754o9cix": true,
    "cm16k73gq014h0mmj5b6jdi9r": false
  }
}

Response

Successful send.

successboolean required

Example response

{
  "success": true
}

Changes

  • ac25499abd64Revision changes
    • breaking

      removed subschema #1 subschema #2 from the request body anyOf list

    • breaking

      removed subschema #1 subschema #2 subschema #3 from the request property oneOf list

    • info

      added subschema #1: Identify by email subschema #2: Identify by user ID to the request body anyOf list

    • info

      added subschema #1: String subschema #2: Number subschema #3: Boolean to the request property oneOf list

  • 74756bcb2e9eRevision changes
    • info

      api operation id sendEvent was added