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

# Create Post

> Create a new LinkedIn post with optional image attachment

Create a new post on LinkedIn with text content and an optional image attachment.

<Note>
  This endpoint costs **1 credit** per request.
</Note>

### Header Parameters

<ParamField header="x-api-key" type="string" required>
  Your API key
</ParamField>

### Body Parameters

<ParamField body="message" type="string" required>
  Text content of the post
</ParamField>

<ParamField body="login_token" type="string" required>
  LinkedIn authentication cookie obtained from the login/verify process
</ParamField>

<ParamField body="country" type="string" default="FR">
  Country code for proxy selection. Available: (US, UK, FR, DE, NL, IT, IL, CA, BR, ES, IN)
</ParamField>

<ParamField body="file" type="string">
  Optional image file URL. Direct link to the image file you want to attach to the post.
</ParamField>

<ParamField body="files" type="array">
  Optional multiple image file URLs for creating carousel posts. Array of direct links to image files.
</ParamField>

### Response

<ResponseField name="status" type="string">
  Request status (success/error)
</ResponseField>

<ResponseField name="message" type="string">
  Detailed status message about the post creation
</ResponseField>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "status": "success",
    "message": "Post created successfully"
  }
  ```
</ResponseExample>

### Notes

#### Post Settings

* Default post visibility is set to "ANYONE" (public)
* Comments are enabled for all users by default

#### Image Requirements

* Image must be provided as a direct URL to the file
* Supported formats:
  * PNG
  * JPEG/JPG
  * Other LinkedIn-supported image formats
* Image restrictions:
  * Must comply with LinkedIn's maximum file size limits
  * Should meet LinkedIn's dimension requirements

#### Features

* Text content with no formatting
* Single image attachment support via URL
* Multiple images support for carousel posts
* Comments enabled by default

#### Automatic Handling

* Image download and upload process
* Post metadata creation
* Visibility and sharing options configuration

#### Limitations & Guidelines

* Subject to LinkedIn's posting frequency limits
* Must comply with LinkedIn's content policies
* Media upload size and format restrictions apply