---
title: "Create a new assistant"
method: POST
path: "/v1/Assistants"
---

# Create a new assistant

`POST /v1/Assistants`

## Request

- Base URL: `https://assistants.twilio.com`
- URL: `https://assistants.twilio.com/v1/Assistants`
- Auth: HTTP basic

create an assistant

## Request body

- AssistantsV1ServiceCreateAssistantRequest
  - `customer_ai` AssistantsV1ServiceCustomerAi
    - `perception_engine_enabled` boolean, required: True if the perception engine is enabled.
    - `personalization_engine_enabled` boolean, required: True if the personalization engine is enabled.
  - `name` string, required: The name of the assistant.
  - `owner` string: The owner/company of the assistant.
  - `personality_prompt` string: The personality prompt to be used for assistant.
  - `segment_credential` AssistantsV1ServiceSegmentCredential
    - `profile_api_key` string: The profile API key.
    - `space_id` string: The space ID.
    - `write_key` string: The write key.

## Response `201`

OK

- AssistantsV1ServiceAssistant
  - `account_sid` string, required: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Assistant resource.
  - `customer_ai` object, required: The Personalization and Perception Engine settings.
  - `id` string, required: The Assistant ID.
  - `model` string, required: The default model used by the assistant.
  - `name` string, required: The name of the assistant.
  - `owner` string, required: The owner/company of the assistant.
  - `url` string: The url of the assistant resource.
  - `personality_prompt` string, required: The personality prompt to be used for assistant.
  - `date_created` string, date-time, required: The date and time in GMT when the Assistant was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `date_updated` string, date-time, required: The date and time in GMT when the Assistant was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.

## Changes

- **2025-05-13** (v1) `0852198458a0`: 1 info
  - the `id` response's property pattern was changed from `^aia_asst_*$` to `^aia_asst_.+$` for the status `201`
- **2024-09-25** (v1) `1ad87f675d4b`: 1 info
  - added the optional property `url` to the response with the `201` status

[Operation history](https://skmtc.dev/twilio/apis/assistants-v1/changes/v1/Assistants/post.md)

---

[API](https://skmtc.dev/twilio/apis/assistants-v1.md) - [All operations](https://skmtc.dev/twilio/apis/assistants-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/assistants-v1/revisions/c5ec7f024ee9?raw)