v54

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-06178189573.7 KB

Functions

Create function triggers

Subscribe a function to one or more event types, optionally scoped to specific senders. Provide eventTypes and senderIds (use null in senderIds for all senders); a trigger is created for each event type and sender combination.

The special event type cron runs the function on a schedule instead of a messaging event: include a cron field with a 5-field UTC cron expression (minimum granularity one minute). A cron trigger ignores the sender axis, and a function may hold several cron triggers with different expressions. The function receives an event with type: "cron" and data.cron.

post/v1/functions/{functionId}/triggers

Path parameters

functionIdstring required

Zavu Function ID.

Request body

eventTypesstring[] required

Event types to subscribe to.

senderIdsstring[] required

Senders to scope the triggers to. Use null for all senders.

cronstring

Required when eventTypes includes cron: a 5-field cron expression (minute hour day-of-month month day-of-week), evaluated in UTC.

Example request

{
  "cron": "0 9 * * 1-5"
}

Response

Triggers created.

addedinteger required

skippedinteger required

Number of triggers that already existed.

Example response

{
  "triggers": [
    {
      "cron": "*/15 * * * *"
    }
  ]
}