> ## 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 SMS AI Agent

> Create SMS-based AI assistants for text messaging automation and recruiter workflows.

### Authorizations

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

<ParamField header="force" type="boolean">
  Force recreate (overwrite existing). Example: `true`
</ParamField>

### Request Body

<ParamField body="name" type="string" required>
  Assistant display name. Example: `"My SMS Assistant"`
</ParamField>

<ParamField body="type" type="string" required>
  Assistant type: `"SMS"`
</ParamField>

<ParamField body="model" type="string" required>
  LLM model: `"cw-llm-1"`
</ParamField>

<ParamField body="api_keys" type="array" required>
  SMS API configuration `[{"api_key_id":134,"type":"SMS"}]`

  <ParamField body="api_key_id" type="number">
    API key ID
  </ParamField>

  <ParamField body="type" type="string">
    Key type: `SMS`
  </ParamField>
</ParamField>

<ParamField body="instructions" type="string" required>
  Detailed recruiter instructions and candidate profiles
</ParamField>

<ParamField body="prompts" type="object">
  Agent prompts with `agent` and `goal`

  <ParamField body="agent" type="string" />

  <ParamField body="goal" type="string" />
</ParamField>

### SMS-Specific Settings

<ParamField body="sms_type" type="string" required>
  SMS direction: `"OUTBOUND"`
</ParamField>

<ParamField body="phone_number" type="string">
  Assigned phone number. Example: `"+13465507166"`
</ParamField>

<ParamField body="kb_id" type="string">
  Knowledge base ID
</ParamField>

<ParamField body="action_ids" type="array">
  Linked action IDs `[]`
</ParamField>

<ParamField body="additional_settings" type="object">
  <ParamField body="additional_settings.idle_time" type="integer">
    Idle timeout in seconds. Example: `86400`
  </ParamField>

  <ParamField body="additional_settings.max_messages" type="integer">
    Maximum messages per conversation. Example: `10`
  </ParamField>
</ParamField>

### Response

**201 Created** - SMS assistant created successfully

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

<ResponseField name="data" type="object">
  <ResponseField name="assistant_id" type="string">New assistant ID</ResponseField>
  <ResponseField name="name" type="string">Assistant name</ResponseField>
</ResponseField>

**400 Bad Request** - Invalid SMS configuration or missing API keys

**401 Unauthorized** - Invalid token