Run mutation

convex.runMutation calls a named mutation and returns its Convex value.

automations/create-convex-message.automation.ts

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

export default automation("Create Convex message", () => {
  onSchedule({ schedule: "0 9 * * *" })
  convex.runMutation({
    functionName: "messages:create",
    arguments: { body: "Daily check-in" },
  })
})

Inputs

Input	Type	Required	Default	Description
`functionName`	`string`	Yes	None	Exported function path.
`arguments`	`Record<string, ConvexValue>`	No	`{}`	Convex function arguments.
`deployment`	`string`	No	`prod`	Deployment reference for project OAuth. Omit it for a deployment-key account.
Second argument: `{ account }`	`string \| IntegrationAccountReference<"convex">`	No	Project default	Connected Convex account.

The mutation runs with the connected project token or deploy key. Prefer an internal mutation for service-only operations and grant only the run-internal permission it needs. The selected deployment must use a hosted .convex.cloud URL. Automate.ax can’t reach a local development deployment.

Built-in triggers

Built-in actions

Runtime utilities

Integrations

Inputs

​Inputs

Inputs