---
title: "Trigger an Event"
method: POST
path: "/event/"
---

# Trigger an Event

`POST /event/`

API to pass an event, which in turn triggers workflows where that event is defined as the trigger.

## Request body

- object
  - `distinct_id` string, required — distinct_id of recipient who should receive the notification
  - `event` string, required — string identifier for the event like `product_purchased`
  - `properties` object — Properties are used to render template or workflow variables in the trigger.
    - `$attachments` union[] — Use this key to pass email attachment in the trigger. You can either pass attachment as a public URL or as a base64-encoded file (limit < 50KB).
      - union
        - object — **Option 1: Pass file as publicly accessible URL** (No limit on file size)
          - `url` string, uri, required — Publicly accessible URL of the file
          - `filename` string — Filename to be shown in email
          - `ignore_if_error` boolean — Ignore the attachment if it fails to load
        - object — Pass file as a **base-64 file** (supported limit < 50KB)
          - `data` string, required — Base64-encoded content of the file
          - `filename` string — Filename to be shown in email
          - `contentType` string
  - `tenant_id` string — string identifier of the tenant this event is associated with
  - `$idempotency_key` string — Idempotency key (valid for 24hours)

## Response `202`

202 - Accepted

- object — Confirmation that the event was accepted for processing.
  - `message` string — Status message indicating the event was accepted.

---

[API](https://skmtc.net/suprsend/apis/suprsend-api.md) · [All operations](https://skmtc.net/suprsend/apis/suprsend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/suprsend/suprsend-api/versions/8bd2574bd2c3/schema)