> ## Documentation Index
> Fetch the complete documentation index at: https://docs.contactswing.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Assistant

> Create a new assistant via the ContactSwing API.

### Authorizations

<ParamField header="Authorization" type="string" required>
  Enter your ContactSwing JWT Bearer token.
</ParamField>

### Request Body

**JSON: AssistantRequest** (see OpenAPI spec)

<ParamField path="name" type="string" required>
  Assistant display name
</ParamField>

<ParamField path="description" type="string">
  Assistant purpose
</ParamField>

<ParamField path="actions" type="array">
  Action IDs array `["action_id_1"]`
</ParamField>

<ParamField path="model" type="string">
  AI model `gpt-4o`
</ParamField>

### Response

**201 Created** - Assistant created successfully

<ResponseField name="ctx_id" type="string">Request context ID</ResponseField>

<ResponseField name="data" type="object">
  <ResponseField name="id" type="string">Assistant ID</ResponseField>
  <ResponseField name="name" type="string">Assistant name</ResponseField>
</ResponseField>

**400 Bad Request** - Invalid input

### Example

```json theme={null}
{
  "name": "SMS Assistant",
  "description": "Handles SMS requests", 
  "actions": ["6f439f98-32f6-4b44-928c-6e890e298d51"]
}
```