> For the complete documentation index, see [llms.txt](https://docs.delphi.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.delphi.ai/advanced/actions/hosted-actions.md). # Hosted Actions Hosted Actions are small automations that Delphi runs for you, on Delphi's own servers. If a webhook is about sending information out to another tool, a Hosted Action is the automation itself, living inside Delphi, so there is nothing for you to host or keep online. You set up the instructions once, and Delphi runs them reliably for as long as you want. The real superpower is that an action can wait. Something like "wait three days after someone goes quiet, then send a friendly follow-up, unless they have already replied" is not possible with a plain webhook, but it is a natural fit here. Hosted Actions are great for follow-up sequences, recurring routines, and automatically tagging or syncing your audience, all without standing up a server of your own. #### Three ways an action can run An action can be triggered in three ways, and you can combine them: * **React to an event.** It runs the moment something happens, using the same events as webhooks, like a conversation ending or a new contact arriving. * **Run on a schedule.** It runs on a regular timer you set, for example every morning, which is perfect for a daily sweep or a recurring cleanup. * **Wait, then act.** This is the durable option. The action can pause for anywhere from a few minutes up to a year, then carry on, even if something restarts in between. It is what powers "do this later, unless something changes first." Once it runs, a Hosted Action can do real work on your behalf: tag and update contacts, send a message or generate text in your Digital Mind's voice, notify you when a human should step in, and securely connect to your other tools like your CRM. #### How one gets built You do not need to be technical to create one. The easiest path is to let an AI coding agent (like Claude Code) build it for you. Setup is mostly copy-and-paste and takes about a minute. **1. Install the Delphi tool.** A one-line install of the Delphi command-line tool: `npm install -g @delphiai/cli` **2. Sign in.** Connect it to your account: `delphi login` **3. Add the skill pack to your coding agent.** This teaches your agent everything about the platform in one step: `delphi skills install` **4. Describe what you want, in plain English.** For example, "build something that emails me whenever a new high-intent contact is captured." Your agent uses the skill pack to write and test the action, then pushes it to Delphi to go live, checking with you first. **5. Manage it in the Developer Platform.** Once live, see each action's status, triggers, and schedule, turn it on or off, store any private keys it needs (like a CRM token), and watch every run in Activity. #### Frequently asked questions * Do I need to know how to code? Not necessarily. Building an action does take some code, but the skill pack lets an AI coding agent build it for you from a plain-English description. Either way, actions are built on a computer and pushed to Delphi, since there is no editor inside the app. * How is this different from a webhook? A webhook sends each event out to a tool that you run and maintain. A Hosted Action is the automation itself, running on Delphi with no server for you to keep online, plus two things a webhook cannot do on its own: run on a schedule, and wait for hours or days before acting. * Can an action really wait days before doing something? Yes. A durable action can sleep for up to a year and then pick up exactly where it left off. That is how "follow up in three days unless they reply" works, with nothing running or costing you anything while it waits. * Is it safe to let Delphi run code for me? Yes. Each action runs in an isolated sandbox that can only reach Delphi and the specific outside services you have allowed. Your secrets stay encrypted, daily spending is capped, and any message it sends still respects each contact's consent. * How do I turn one off? You can deactivate any action at any time from the Developer Platform. Its code is kept, it simply stops running, and you can switch it back on or delete it whenever you like. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.delphi.ai/advanced/actions/hosted-actions.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.