> For the complete documentation index, see [llms.txt](https://docs.talkstack.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.talkstack.ai/agent/create-a-new-agent.md).

# Create a new Agent

**Step 1: Prepare Your Request**

* **Endpoint:** `/agent/create-agent`
* **Method:** `POST`
* **URL:** `https://api.talkstackai.com/agent/create-agent`
* **Headers:** Include `Content-Type: application/json`.
* **Authorization:** Bearer token or x-api-key in headers

**Step 2: Create the Request Body**

* `name`: name of the AI Agent to be created.
* `systemInstruction`: instructions to the bot. The AI Agent will use these instructions for calling. For Example: "You are an agent called John. You can take any question related to Chemistry."
* `projectId`: the id of the project for which the agent is to be created.
* `phoneNumber`: phone number to be given to the AI Agent. The AI Agent will use this phone number to make calls.
* `voice_id`: It is the id of the voice with which agent speaks.

```
{
    "name": "Jack",
    "systemInstruction": "You are an agent called John. You can take any questions related to Mathematics.",
    "projectId": "XXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "voice_id": "xxxxxxxxxxxxxxxxxxxxxxxx"
}
```

**Step 3: Send the Request**

Use your preferred HTTP client to send the POST request with the JSON body.

**Step 4: Handle the Response**

The response will provide detailed information about the new agent created.

**Troubleshooting**

* `400 Bad Request`: If the projectId, name, systemInstruction, or phoneNumber is missing in the request.
* `500 Internal Server Error`: For errors in creating a new agent.

Last updated 15 hours ago