Connect your website and business APIs.

1. 1

   Find the API docs and make a restricted credential

   In the website platform or service you want to connect, open its developer/API settings. Create an API key or token that has only the required permissions. If your website is custom-built, ask its developer for the API base URL, endpoint documentation, and an authentication method.

2. 2

   Add a connection in Company → Integrations

   Enter a clear name, the API base URL (for example https://api.example.com/v1), what your agents should use it for, and the auth method. Add credentials in the secure credential fields. Do not paste a product-page URL such as https://example.com/products as the API base URL unless the API provider explicitly documents it as an API endpoint.

3. 3

   Test a safe endpoint

   Expand the saved connection, enter an endpoint path documented by the API provider, and start with a read-only GET endpoint. The test makes a real HTTP request. POST, PUT, PATCH, and DELETE can change data, so only use them when you understand the endpoint’s effects.

4. 4

   Use the connection in an agent workflow

   Open a company agent in Agent Builder, add an HTTP Request node, select the saved Company API Connection, choose a method, and enter the relative endpoint path (such as /products). Add JSON headers only when the API requires non-authentication headers, then map request body values from workflow inputs or upstream nodes.

5. 5

   Run the workflow with realistic test data

   Run the agent and inspect the HTTP node output. Confirm the status code and response fields, handle empty/not-found responses, and avoid sending unnecessary personal or payment data. Keep credentials in Company → Integrations, not in node text, workflow prompts, or frontend code.

Connection: Store API
Method:     GET
URL:        /products/{{input.productId}}
Body:       (empty)

Example response:
{
  "id": "coffee-001",
  "name": "Single-origin coffee",
  "available": true
}

1. Step 1

   Create a company agent

   From the Company dashboard, build or open an agent in the target company/workspace.

2. Step 2

   Add a Webhook Trigger

   Set its endpoint path (for example website-events), HTTP method (usually POST), authentication (Bearer or API key), and a strong random secret.

3. Step 3

   Activate and copy the endpoint

   Activate the agent. Its endpoint is https://<your-workers-domain>/api/integrations/webhook/<agent-id>/<path>. Company → Integrations shows an endpoint preview for active company agents.

4. Step 4

   Call it from your website server

   Send the configured method, JSON body, and matching authentication header from your backend—not from public browser JavaScript.

const response = await fetch(
  process.env.DENBEGNAYE_ORDER_WEBHOOK_URL!,
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization:
        `Bearer ${process.env.DENBEGNAYE_WEBHOOK_SECRET!}`,
      "X-Webhook-Event-Id": order.id,
    },
    body: JSON.stringify({
      event: "order.created",
      orderId: order.id,
      customerEmail: order.customer.email,
      total: order.total,
    }),
  }
);

if (!response.ok) {
  throw new Error(`Webhook returned ${response.status}`);
}

Troubleshooting

Common setup issues