> For the complete documentation index, see [llms.txt](https://pycai.gitbook.io/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pycai.gitbook.io/welcome/api/post/create.md).

# create

Create a post

```python
client.post.create('POST_TYPE', 'EXTERNAL_ID', 'TITLE')
```

### post\_type <mark style="color:green;">\[str]</mark>

Can be `POST` (with description and image) or `CHAT` (chat with character)

### external\_id <mark style="color:green;">\[str]</mark>

`topic_id` when `POST`, `char` when `CHAT`

### title <mark style="color:green;">\[str]</mark>

Post title

### text <mark style="color:green;">\[str]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

Post text

### post\_visibility <mark style="color:green;">\[str]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

Who can view your post, can be `PUBLIC` or `UNLISTED`

### post\_num\_messages\_loaded <mark style="color:green;">\[int]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

The number of messages that will be in the post

### image\_rel\_path <mark style="color:green;">\[str]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

PATH to image in CAI servers

### token <mark style="color:green;">\[str]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

You can set a specific token for the function, it will be executed from the specified token