1. Get an API key
Create a client API key in your dashboard, then keep it handy — you'll paste it into your tool.
2. The one endpoint you need
Every integration calls the same endpoint. Send the agent's ID and an input; get the agent's reply back.
| Method | POST |
|---|---|
| URL | https://automatedworx.com/api/agent-execute.php |
| Header | X-API-Key: YOUR_CLIENT_API_KEY |
| Body (JSON) | { "agent_id": 12, "input": "..." } |
| Reply | the agent's answer is in output |
# request curl -X POST https://automatedworx.com/api/agent-execute.php \ -H "X-API-Key: YOUR_CLIENT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"agent_id": 12, "input": "Qualify this lead: Acme Corp, 500 staff"}' # reply { "success": true, "output": "Strong ICP fit — 500 staff matches...", "model": "claude-sonnet-5", "tokens_used": 320 }
3. Recipes for your tool
Zapier
Webhooks by Zapier
- Add an action → Webhooks by Zapier → POST.
- URL: the endpoint above.
- Payload Type: JSON.
- Data:
agent_id= your ID,input= a field from the previous step. - Headers:
X-API-Key= your key. - Use
outputin later steps (Slack, Gmail, Sheets…).
Make.com
HTTP module
- Add an HTTP → Make a request module.
- Method POST, URL = the endpoint above.
- Header:
X-API-Key= your key. - Body type Raw / JSON:
{"agent_id":12,"input":"{{...}}"}. - Map
outputdownstream.
n8n
Import a ready workflow
- Download the workflow below.
- In n8n: Workflows → Import from File.
- Open the HTTP node, set your key +
agent_id. - The reply is in
{{ $json.output }}.
Also available
- Website widget — embed a chat bubble on any site (one script tag). See any agent's Integrate tab.
- CLI — run agents from your machine or cron: command-line docs.
- Webhooks — have an agent post its result to your own endpoint.
Tip: the response also includes
model, tokens_used, and duration_ms, and usage counts against your plan just like the dashboard.