Waymaker
Ambassadors

Creating Ambassadors

Basic information about the ambassador — name, description, status, connected tables, and recent invocations.

ServerlessCreateSetup

Ambassadors are serverless functions that run on Waymaker Host. They handle background tasks, scheduled jobs, API integrations, and custom logic — without managing servers.

Creating an ambassador

  1. Open Ambassadors from the Host module bar
  2. Click Create Ambassador
  3. Enter a name and optional description
  4. Connect a GitHub repository (or create one)
  5. Click Create

Your ambassador is created and ready for code.

What ambassadors can do

Use caseExample
Scheduled jobsSend a weekly report email every Monday
API integrationsSync data from a third-party API into a Commander table
WebhooksReceive incoming webhook events and process them
Background tasksGenerate a PDF report when a task is completed
Custom logicCalculate metrics and update a dashboard
AI extractionQualify leads from form submissions using Edge AI
AI processingProcess uploaded documents with AI vision
AI generationGenerate summaries and reports using One AI

The ambassador detail page

Once created, the detail page has four tabs:

Overview

Basic information about the ambassador — name, description, status, connected tables, and recent invocations.

Invocations

A log of every time the ambassador ran:

  • Timestamp
  • Duration
  • Status (success, failed, timeout)
  • Input and output data

Use this tab to debug failed runs and monitor performance.

Settings

Configure:

  • GitHub repository — the source code location
  • Schedule — cron expression for recurring runs (e.g., 0 9 * * 1 for every Monday at 9am)
  • Authentication mode — how the ambassador authenticates with external services

Environment

Manage environment variables (API keys, secrets, configuration):

  • Set variables that your code can access at runtime
  • Variables are encrypted and never exposed in logs
  • See Environment Variables for details

Connecting to tables

Ambassadors declare which Commander tables they access through a waymaker.config.ts manifest. The connection appears in the Connected Tables panel on the ambassador's detail page, so you always know which data your ambassador reads or writes. The tables themselves are managed in Commander.

Deploying

Push code to your connected GitHub repository. Host automatically builds and deploys your ambassador. Check the Monitor to confirm the deployment succeeded.

Next steps