Start manually

This first automation uses an HTTP trigger so you can deploy and test it without connecting an external account.

Create the project

Start in an empty directory and sign in to Automate.ax:

mkdir hello-automate
cd hello-automate
bunx automate.ax login

Initialize the Automate.ax project:

bunx automate.ax init

Follow the prompts to choose an organization and name the project. Automate.ax adds the package, configuration, and an example automation.

Write the automation

Open automations/example.automation.ts and replace it with:

automations/example.automation.ts

import { automation, onHttpRequest, respondToHttpRequest, t } from "automate.ax"

export default automation("Confirm an HTTP request", () => {
  const request = onHttpRequest()

  respondToHttpRequest({
    body: t`Automate.ax received ${request.method} ${request.path}.`,
    requestId: request.requestId,
  })
})

automation gives the automation a name.
onHttpRequest creates the web endpoint that starts it.
respondToHttpRequest sends a response back to the caller.
t builds a string from values that arrive when the automation runs.

The request arrives as a signal. Passing request.requestId addresses the response to that exact request and makes Automate.ax wait for it automatically.

Deploy it

Typecheck the project:

bunx tsc --noEmit

Deploy the project:

bunx automate.ax deploy

Automate.ax publishes the automation and prints its HTTP trigger URL. It also saves the deployment details in .automate/deployment.md.

Run it

Read the HTTP trigger URL from the deployment manifest and call it:

curl "$(grep -m1 '^https://automate.ax/x/' .automate/deployment.md)"

You receive a response like:

Automate.ax received GET /.

Connect integrations

Browse the Integrations section in Reference, or open Slack, Google Sheets, or Linear directly.
Use multiple accounts from the same service when a project needs separate identities.
Call an external API when packaged actions don’t cover the operation.

Start

Concepts

Guides

Create the project

Write the automation

Deploy it

Run it

Connect integrations

​Create the project

​Write the automation

​Deploy it

​Run it

​Connect integrations

Create the project

Write the automation

Deploy it

Run it

Connect integrations