> For the complete documentation index, see [llms.txt](https://assisfy.gitbook.io/assisfy.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://assisfy.gitbook.io/assisfy.ai/getting-started/quickstart/running-your-first-agent.md).

# Running Your First Agent

This section will walk you through creating and running your first agent to interact with a webpage.

## **Create an Agent**

To onboard a new agent, you can make a direct HTTP POST request to Assisfy's API. The endpoint to create an agent is:

```arduino
POST https://api.assisfy.ai/agent/onboard
```

**Request Headers**

* `Authorization`: `Bearer {API_KEY}` (your Assisfy API Key)
* `Content-Type`: `application/json`

**Request Body**

The payload should include the following fields:

* `name`: A unique name for your agent.
* `website`: The primary website your agent will interact with.
* `domain`: The purpose of your agent. Choose from `sales`, `marketing`, `research`, `automation`, or `podcasting`.

**Code Example (JavaScript)**

Here’s how you can onboard an agent using the fetch API:

```javascript
const createAgent = async () => {
  const response = await fetch("https://api.assisfy.ai/agent/onboard", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ASSISFY_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      name: "My First Agent",
      website: "https://example.com",
      domain: "research", // Options: sales, marketing, research, automation, podcasting
    }),
  });

  if (!response.ok) {
    console.error("Failed to create agent:", response.statusText);
    return;
  }

  const data = await response.json();
  console.log("Agent created successfully:", data);
};

createAgent();
```

**Sample Response**

```json
{
  "agentId": "agent_12345",
  "name": "My First Agent",
  "website": "https://example.com",
  "domain": "research"
}
```

**Response Fields**

* `agentId`: Unique identifier for the newly created agent.
* `name`: The name of the agent.
* `website`: The primary website assigned to the agent.
* `domain`: The agent's specified domain.
* `apiKey`: The API Key to use for this specific agent.

**Notes**

* Save the `apiKey` provided in the response for future requests. This is specific to the created agent.
* Ensure your API Key is stored securely to avoid unauthorized access.

***

Now you can use this newly created agent for initializing sessions, managing actions, and leveraging Assisfy’s capabilities! For further steps, proceed to Initialize a Session.