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

# Create Persona

> Create a new persona.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Body Parameters

**name** `string` *required*

Display name for the persona.

**role** `string`

Role assigned to the persona.

**description** `string`

Description of the persona's purpose and use case.

**tags** `array`

Array of tags to associate with the persona.

**image\_url** `string`

URL of the persona's profile image.

**call\_config** `object`

Call configuration settings for the persona.

**call\_config**

**voice** `string`

Voice identifier to use for calls.

**record** `boolean`

Whether to record calls.

**language** `string`

Language code for the persona.

**background** `string`

Background audio setting.

**max\_duration** `number`

Maximum call duration in minutes.

**wait\_for\_greeting** `boolean`

Whether to wait for greeting before starting.

**interruption\_threshold** `number`

Interruption sensitivity threshold.

**orchestration\_prompt** `string`

Orchestration prompt for the persona (optional).

**personality\_prompt** `string`

Personality and behavior prompt for the persona.

**default\_tools** `array`

Array of default tools enabled for the persona.

**pathway\_conditions** `array`

Array of pathway routing conditions for the persona.

**pathway condition**

**name** `string` *required*

Name of the pathway condition.

**prompt** `string` *required*

Prompt that triggers this pathway condition.

**pathway\_id** `string` *required*

ID of the pathway to route to.

**pathway\_version** `string` *required*

Version of the pathway to use.

**start\_node\_id** `string` *required*

Starting node ID within the pathway.

**kb\_ids** `array`

Array of knowledge base item IDs to connect to the persona.

### Response

**data** `object`

The created persona object.

**persona object**

**id** `string`

Unique identifier for the persona.

**name** `string`

Display name of the persona.

**role** `string`

Role assigned to the persona.

**description** `string`

Description of the persona's purpose.

**tags** `array`

Array of tags associated with the persona.

**image\_url** `string`

URL of the persona's profile image (null if none).

**created\_at** `string`

ISO 8601 timestamp of when the persona was created.

**updated\_at** `string`

ISO 8601 timestamp of when the persona was last modified.

**deleted\_at** `string`

ISO 8601 timestamp of when the persona was deleted (null if active).

**user\_id** `string`

ID of the user who owns this persona.

**current\_production\_version\_id** `string`

ID of the current production version.

**current\_draft\_version\_id** `string`

ID of the current draft version.

**current\_production\_version** `object`

Complete production version object.

**current\_draft\_version** `object`

Complete draft version object.

**errors** `string`

Any errors that occurred (null if none).

```json Response (Success) theme={null}
{
  "data": {
    "id": "12345678-1234-1234-1234-123456789012",
    "name": "Blandie",
    "role": null,
    "description": null,
    "tags": [],
    "image_url": null,
    "created_at": "2025-09-23T15:13:36.348Z",
    "updated_at": "2025-09-23T15:13:36.412Z",
    "deleted_at": null,
    "user_id": "12345678-1234-1234-1234-123456789012",
    "current_production_version_id": "12345678-1234-1234-1234-123456789012",
    "current_draft_version_id": "12345678-1234-1234-1234-123456789012",
    "current_production_version": {
      "id": "12345678-1234-1234-1234-123456789012",
      "persona_id": "12345678-1234-1234-1234-123456789012",
      "version_type": "production",
      "version_number": 1,
      "orchestration_prompt": null,
      "personality_prompt": "You are a helpful assistant",
      "pathway_conditions": null,
      "kb_ids": [],
      "call_config": null,
      "default_tools": [],
      "promoted_from_version_id": null,
      "promoted_at": "2025-09-23T15:13:36.368Z",
      "promoted_by": null,
      "created_at": "2025-09-23T15:13:36.369Z",
      "updated_at": "2025-09-23T15:13:36.369Z"
    },
    "current_draft_version": {
      "id": "12345678-1234-1234-1234-123456789012",
      "persona_id": "12345678-1234-1234-1234-123456789012",
      "version_type": "draft",
      "version_number": 2,
      "orchestration_prompt": null,
      "personality_prompt": "You are a helpful assistant",
      "pathway_conditions": null,
      "kb_ids": [],
      "call_config": null,
      "default_tools": [],
      "promoted_from_version_id": "12345678-1234-1234-1234-123456789012",
      "promoted_at": null,
      "promoted_by": null,
      "created_at": "2025-09-23T15:13:36.390Z",
      "updated_at": "2025-09-23T15:13:36.390Z"
    }
  },
  "errors": null
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.