On event

convex.onEvent exposes a signed endpoint for app-defined events emitted from a Convex action.

automations/convex-invoice-paid.automation.ts

import { automation, sendEmail } from "automate.ax"
import { convex } from "automate.ax/convex"

export default automation("Convex invoice paid", () => {
  const event = convex.onEvent({ name: "invoice.paid" })
  sendEmail({ subject: "Invoice paid", text: event.id })
})

Copy the trigger’s endpoint, connect Convex with the deployment-key method, and set AUTOMATE_AX_EVENT_ENDPOINT and AUTOMATE_AX_WEBHOOK_SECRET in Convex. Use the same signing secret on the connected account. Emit from a Convex action:

import { v } from "convex/values"
import { action } from "./_generated/server"
import { emitConvexEvent } from "automate.ax/convex/events"

export const emitInvoicePaid = action({
  args: { invoiceId: v.id("invoices") },
  handler: async (_context, { invoiceId }) => {
    await emitConvexEvent({
      endpoint: process.env.AUTOMATE_AX_EVENT_ENDPOINT!,
      id: invoiceId,
      name: "invoice.paid",
      payload: { invoiceId },
      signingSecret: process.env.AUTOMATE_AX_WEBHOOK_SECRET!,
    })
  },
})

id is the idempotency key: retries with the same ID produce one event. The signature covers the exact body, timestamp, and ID, and Automate.ax rejects requests older than five minutes. Trigger data contains id, name, payload, and emittedAt.

Built-in triggers

Built-in actions

Runtime utilities

Integrations