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

# Create a new assistant

`POST /v1/Assistants`

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.

---

[API](https://skmtc.net/twilio/apis/assistants-v1.md) · [All operations](https://skmtc.net/twilio/apis/assistants-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/assistants-v1/revisions/c5ec7f024ee9/schema)