> For the complete documentation index, see [llms.txt](https://docs.yansalabs.com/tracy-social-ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yansalabs.com/tracy-social-ai/technical-docs/creating-a-post.md).

# Creating a Post

{% hint style="info" %}
A **Social Post** contains all of the details about the AI request, AI response, and social platform destination for a particular post.
{% endhint %}

The Social Post form is organized into sections to simplify configuration:

* **Main Form**: Core information about post content, approval, and state
* **AI Details**: Details about the AI request & configuration
* **Social Details**: Details about the social platform configuration
* **Log**: Activity occurring on the Social Post record throughout its lifecycle

<div><figure><img src="/files/6NokOI2U2pHqwiomGRit" alt=""><figcaption><p>Main Form &#x26; AI Details</p></figcaption></figure> <figure><img src="/files/9vHkQJo8jLpNw4aOAQBh" alt=""><figcaption><p>Social Details</p></figcaption></figure> <figure><img src="/files/ndK8wlpN8gNXAtMQBYdv" alt=""><figcaption><p>Log</p></figcaption></figure></div>

{% hint style="info" %}
A Social Post can be progressed through its stages via buttons in the form header. Here you can select to **Request Approval** for a post, **Generate Content** from your AI Provider, and **Post Now** to your Social Platform.
{% endhint %}

### Main Form

* **Approval group**: Group responsible for approving the Social Post & triggering a send to the appropriate Social Platform.
* **State/Approval**: The state & approval status of the Social Post, respectively.
* **Post content**: Content to be posted to the Social Platform. This is generally AI-generated, but can be edited prior to posting. Any images attached to the Social Post record will also be included with the post.

### AI Details

{% hint style="info" %}
You can always trigger a re-generation of Social Post content by clicking the **Generate Content** button in the form header.
{% endhint %}

#### Content Settings

* **Prompt**: [**AI Prompt**](/tracy-social-ai/technical-docs/components-of-a-post/ai-prompts.md) used to generate the Social Post
* **Persona**: [**AI Persona**](/tracy-social-ai/technical-docs/components-of-a-post/ai-personas.md) used to generate the Social Post
* **Context statements**: One or more [**Context Statements**](/tracy-social-ai/technical-docs/components-of-a-post/context-statements.md) used to generate the Social Post
* **Instruction statements**: One or more [**Instruction Statements**](/tracy-social-ai/technical-docs/components-of-a-post/instruction-statements.md) used to generate the Social Post

#### Provider Settings

* **AI connector**: [**AI Connector**](/tracy-social-ai/technical-docs/getting-started/setting-up-an-ai-connector.md) through which the AI request is being made
* **AI model**: [**AI Model**](/tracy-social-ai/technical-docs/getting-started/setting-up-an-ai-connector/ai-models.md) against which the AI request is being made
* **Temperature**: Temperature setting for AI request. Defaults to what is specified in [General Settings](/tracy-social-ai/technical-docs/general-settings.md)
* **Max tokens**: Max tokens allowed for AI request. Defaults to what is specified in [General Settings](/tracy-social-ai/technical-docs/general-settings.md)

#### Communication

All data within the Communication section comes from the related **AI Request** record. All AI Request records can be viewed at **Tracy Social AI -> AI Connectors -> AI Requests** in the left nav.

* **AI request**: The related AI Request in the **AI Request** table
* **Status code**: Status code of the AI Request, such as 200/404/etc
* **Created by**: If the Social Post was created by a [Scheduler](/tracy-social-ai/technical-docs/scheduling-posts.md), this indicates the Schedule that triggered the post
* **Request**: The JSON payload of the request made to the [AI Provider](/tracy-social-ai/technical-docs/getting-started/setting-up-an-ai-connector/ai-providers.md)
* **Response**: The JSON payload of the response received by the [AI Provider](/tracy-social-ai/technical-docs/getting-started/setting-up-an-ai-connector/ai-providers.md)

### Social Details

{% hint style="info" %}
You can test any 'Pre-Publish' [**Content Transformers**](/tracy-social-ai/technical-docs/getting-started/setting-up-a-social-platform/content-transformers.md) prior to publishing by clicking the **Test "Pre-Publish" Content Transformers** link at the bottom of the form. Results will be shown in the Activity Log.
{% endhint %}

#### Post Settings

* **Social platforms**: The [Social Platforms](/tracy-social-ai/technical-docs/getting-started/setting-up-a-social-platform.md) to which the post will be sent
* **Post schedule**: Details of when the post will be sent to the Social Platforms
  * **Immediately (Upon Approval)**: Send immediately upon approval of the Social Post. If no Approval Group is specified, the Social Post will be submitted immediately with no approval step.
  * **At Specific Time**: Send at the time specified
  * **Within Schedule**: Post at a random time within the provided Schedule
  * **On Demand**: Post only when the **Post Now** button in the form header is clicked

#### Post Options

* **Social options**: Optionally, a JSON object defining additional options to be added to the request payload sent to the [Social Platform](/tracy-social-ai/technical-docs/getting-started/setting-up-a-social-platform.md)

### Log

The Activity Log contains a running list of all activity on the Social Post, including all AI communication, Social Platform, Approvals, etc.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.yansalabs.com/tracy-social-ai/technical-docs/creating-a-post.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.