Error

A valid request URL is required to generate request examples

{
  "success": true,
  "data": {
    "id": "obt_9f4c02a71e6d3b85",
    "provider": "",
    "triggerKey": "appointment_scheduled",
    "providerEvent": "APPOINTMENT_CREATE",
    "delivery": "static_webhook",
    "agentId": "agt_4f9c2b7e10a24d51",
    "callerNumberId": "pn_6a2f9c31e07b4d58",
    "intentType": "appointment_confirmation",
    "messageCategory": "informational",
    "audienceType": "consumer",
    "consentBasis": "ebr",
    "scheduleOffset": 60,
    "enabled": false,
    "mapping": [
      {
        "var": "recipient_phone",
        "eventPath": [
          "customer",
          "phone"
        ],
        "transform": "phone_normalize"
      },
      {
        "var": "recipient_name",
        "eventPath": [
          "customer",
          "first_name"
        ]
      }
    ],
    "createdAt": "2026-07-13T15:04:00.000Z",
    "updatedAt": "2026-07-13T15:04:00.000Z"
  }
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

Outbound

Auto-map a goal to an outbound trigger binding (the AI assistant)

Given a natural-language GOAL, an LLM proposes the event-leaf → intent-var mapping over the trigger’s declared output fields; the proposal is VALIDATED by the compiler (with one self-correct retry) and created as a DISABLED trigger for review. 503 if no LLM is configured; 422 if a valid mapping couldn’t be produced; 409 if not connected. Use this when you’d rather describe the goal than hand-map fields. To specify the event→field bindings explicitly, use createOutboundTrigger (POST …/triggers) instead. Either way the trigger lands DISABLED for your review before it can dial.

POST

agents

{agentId}

integrations

{kind}

triggers

auto

Error

A valid request URL is required to generate request examples

{
  "success": true,
  "data": {
    "id": "obt_9f4c02a71e6d3b85",
    "provider": "",
    "triggerKey": "appointment_scheduled",
    "providerEvent": "APPOINTMENT_CREATE",
    "delivery": "static_webhook",
    "agentId": "agt_4f9c2b7e10a24d51",
    "callerNumberId": "pn_6a2f9c31e07b4d58",
    "intentType": "appointment_confirmation",
    "messageCategory": "informational",
    "audienceType": "consumer",
    "consentBasis": "ebr",
    "scheduleOffset": 60,
    "enabled": false,
    "mapping": [
      {
        "var": "recipient_phone",
        "eventPath": [
          "customer",
          "phone"
        ],
        "transform": "phone_normalize"
      },
      {
        "var": "recipient_name",
        "eventPath": [
          "customer",
          "first_name"
        ]
      }
    ],
    "createdAt": "2026-07-13T15:04:00.000Z",
    "updatedAt": "2026-07-13T15:04:00.000Z"
  }
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Flowyte secret API key (Authorization: Bearer flowyte_sk_live_…). Scope-gated; is scoped to your organization — a key can never reach another tenant. The listed scopes in each operation's apiKey requirement are the scopes that key must hold. The tokenUrl is nominal: keys are minted in the dashboard.

Path Parameters

agentId

string

required

The agent this resource is scoped to (the UUID returned by createAgent / listAgents).

kind

enum<string>

required

The integration provider (connector). One of the supported connector slugs: native providers (google_calendar, google_sheets, calendly, hubspot, ``, square, opentable, shopify), SQL databases (postgres, mysql), the universal Zapier MCP fallback (zapier), or Composio (composio).

Available options:

google_calendar,

google_sheets,

calendly,

hubspot,

square,

opentable,

shopify,

postgres,

mysql,

zapier,

composio

Body

application/json

triggerKey

string

required

goal

string

required

A natural-language description of the recipient/data to call about.

callerNumberId

string

required

Available options:

pewc,

express,

ebr,

none

audienceType

enum<string>

default:consumer

Available options:

consumer,

business

targetCampaignId

string

greetingTemplate

string

scheduleOffset

integer

Response

The compiled (disabled) trigger.

success

boolean

required

data

object

required

A compiled outbound trigger ("when {event} in {provider} → call {agent}"). The server-authored fields (agentId, callerNumberId, messageCategory, intentType, consentBasis) are PINNED at compile; the inbound payload can never choose them. It lands disabled and the operator enables it (a standing consent attestation).

Show child attributes

message

string

errors

object[]

Show child attributes

Compile an outbound trigger (when {event} → call) onto an agent Enqueue a single outbound call

Using the API

Endpoints

Auto-map a goal to an outbound trigger binding (the AI assistant)

Authorizations

Path Parameters

Body

Response