Configuration

A Stateful Actor project uses the umbrella telnyx.toml manifest (the same file your [[secrets]] and [telnyx] bindings live in). The actor declaration is a [[actors]] array:

name = "account"                # function name
main = "src/index.ts"          # entry — exports the fetch handler (and the class, if this func owns the type)
compatibility_date = "2026-05-01"

[[actors]]
binding = "ACCOUNT"           # the property on env — your handle
type    = "Account"           # the class to instantiate per name

Field	Meaning
`name`	Function name (used by the platform to register the func)
`main`	Entry module — exports the `default { fetch }` handler, plus the actor class when this function owns the type (a reference binding ships no class)
`compatibility_date`	Runtime compatibility pin
`[[actors]] binding`	The name you’ll use as `env.<binding>` from your function
`[[actors]] type`	The class name to instantiate per actor name

Constraints, enforced at ship time: binding and type must be identifiers and must not contain __; type is capped at 32 characters; binding names must be unique across all bindings in the file, and SECRETS is reserved as a binding name when the file has a [[secrets]] block. Multiple [[actors]] blocks are allowed — including two bindings pointing at the same type.

Actor Namespace — the env.<binding> this declares
Project Structure — the two-export project shape

Actor Alarms

Errors

⌘I

Overview

Get Started

Concepts

Reference

Guides

For AI Agents

​Related

Related