Content & Posts

What You Can Build

Content Schedulers: Plan and queue posts for optimal times
Cross-Platform Publishing: Sync content across multiple accounts
Content Management Systems: Organize, tag, and track post performance
Audience Polling: Publish posts with polls and collect fan preferences
Story Automation: Auto-post stories and manage ephemeral content

Quick Example

Create a new post:

const response = await fetch("https://api.ofauth.com/v2/access/posts", {
  method: "POST",
  headers: {
    apikey: "YOUR_API_KEY",
    "x-connection-id": "conn_abc123",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    text: "New content just dropped! 🔥",
    mediaItems: [123, 456] // Media IDs from vault
  })
})

const post = await response.json()
console.log("Post created:", post.id)

import requests

response = requests.post(
    "https://api.ofauth.com/v2/access/posts",
    headers={
        "apikey": "YOUR_API_KEY",
        "x-connection-id": "conn_abc123",
        "Content-Type": "application/json"
    },
    json={
        "text": "New content just dropped! 🔥",
        "mediaItems": [123, 456]
    }
)
print("Post created:", response.json()["id"])

Common Operations

List Posts

Get posts from a user (use me for your own account):

const response = await fetch("https://api.ofauth.com/v2/access/users/me/posts", {
  headers: {
    apikey: "YOUR_API_KEY",
    "x-connection-id": "conn_abc123"
  }
})

const posts = await response.json()

Get Post Details

const response = await fetch("https://api.ofauth.com/v2/access/posts/POST_ID", {
  headers: {
    apikey: "YOUR_API_KEY",
    "x-connection-id": "conn_abc123"
  }
})

const post = await response.json()
// Returns full post with media, likes, comments, etc.

Schedule a Post

Create a post to be published later:

const response = await fetch("https://api.ofauth.com/v2/access/posts", {
  method: "POST",
  headers: {
    apikey: "YOUR_API_KEY",
    "x-connection-id": "conn_abc123",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    text: "Coming tomorrow! 🎉",
    mediaItems: [123],
    scheduledDate: "2024-12-25T12:00:00Z"
  })
})

Create PPV Post

Post with pay-per-view pricing:

const response = await fetch("https://api.ofauth.com/v2/access/posts", {
  method: "POST",
  headers: {
    apikey: "YOUR_API_KEY",
    "x-connection-id": "conn_abc123",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    text: "Exclusive content 🔒",
    mediaItems: [123, 456],
    price: 14.99 // PPV price ($3-$200)
  })
})

Create Poll Post

const response = await fetch("https://api.ofauth.com/v2/access/posts", {
  method: "POST",
  headers: {
    apikey: "YOUR_API_KEY",
    "x-connection-id": "conn_abc123",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    text: "What should I post next?",
    poll: {
      options: ["Behind the scenes", "Full set preview"],
      type: 1,
      dueDays: 7
    }
  })
})

Edit a Post

const response = await fetch("https://api.ofauth.com/v2/access/posts/POST_ID", {
  method: "PUT",
  headers: {
    apikey: "YOUR_API_KEY",
    "x-connection-id": "conn_abc123",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    text: "Updated caption! ✨",
    mediaItems: [123]
  })
})

Delete a Post

const response = await fetch("https://api.ofauth.com/v2/access/posts/POST_ID", {
  method: "DELETE",
  headers: {
    apikey: "YOUR_API_KEY",
    "x-connection-id": "conn_abc123"
  }
})

API Endpoints

Endpoint	Method	Description
`/v2/access/posts`	POST	Create a new post
`/v2/access/posts/{postId}`	GET	Get post details
`/v2/access/posts/{postId}`	PUT	Edit a post
`/v2/access/posts/{postId}`	DELETE	Delete a post
`/v2/access/users/{userId}/posts`	GET	List user’s posts

Full API Reference

See complete endpoint documentation

Query Parameters

List Posts Query

Parameter	Type	Default	Description
`limit`	number	10	Results per page (1-10)
`sortBy`	string	”publish_date”	Sort by: `publish_date`, `tips`, `favorites_count`
`sortDirection`	string	”desc”	Sort direction: `asc`, `desc`
`pinned`	boolean	false	Include pinned posts only
`includePostCounts`	boolean	false	Include engagement counters
`beforePublishTime`	string	-	Pagination cursor (ISO date)

Create Post Options

Field	Type	Description
`text`	string	Post caption (supports markdown)
`mediaItems`	(number\|string)[]	Media references (see `mediaItems` reference)
`price`	number	PPV price ( $3-$ 200, optional)
`isLockedText`	boolean	Lock text behind paywall
`previewMediaCount`	number	How many `mediaItems` are previews. Uses the first N items from left to right.
`scheduledDate`	string	ISO date for scheduled posting
`poll`	object	Poll config with `options`, `type`, and `dueDays`
`expireAfter`	number	Days until post expires (1-30)
`fundRaisingTargetAmount`	number	Fundraising goal (min $10)
`fundRaisingTipsPresets`	number[]	Tip amount presets (max 4)

For all accepted mediaItems values and validation rules, see the mediaItems reference.

For poll posts, use the managed poll object. OFAuth translates it to the upstream OnlyFans poll fields automatically.

Post Data Structure

Each post object includes:

{
  "id": 123456,
  "text": "Post caption here",
  "postedAt": "2024-01-15T10:30:00Z",
  "price": null,
  "isPinned": false,
  "likesCount": 42,
  "commentsCount": 5,
  "media": [
    {
      "id": 789,
      "type": "photo",
      "files": {
        "full": { "url": "https://media.ofauth.com/...", "width": 1920, "height": 1080 }
      }
    }
  ]
}

Tips & Best Practices

Media First: Always upload media to the vault first using the /uploads/init flow, then reference the media IDs in mediaItems when creating posts.

Scheduling: Scheduled posts are stored in OnlyFans’ queue. Use scheduledDate as an ISO 8601 date string.

Content Guidelines: All content posted through OFAuth must comply with OnlyFans’ terms of service. Violations can result in account suspension.

Media & Vault

Upload media before creating posts

Messaging & Chats

Share content via direct messages

Authentication

Realtime

Messaging

Content

Media

Management

Content & Posts

What You Can Build

Quick Example

Common Operations

List Posts

Get Post Details

Schedule a Post

Create PPV Post

Create Poll Post

Edit a Post

Delete a Post

API Endpoints

Full API Reference

Query Parameters

List Posts Query

Create Post Options

Post Data Structure

Tips & Best Practices

Media & Vault

Messaging & Chats

​What You Can Build

​Quick Example

​Common Operations

​List Posts

​Get Post Details

​Schedule a Post

​Create PPV Post

​Create Poll Post

​Edit a Post

​Delete a Post

​API Endpoints

Full API Reference

​Query Parameters

​List Posts Query

​Create Post Options

​Post Data Structure

​Tips & Best Practices

​Related Guides

Media & Vault

Messaging & Chats

What You Can Build

Quick Example

Common Operations

List Posts

Get Post Details

Schedule a Post

Create PPV Post

Create Poll Post

Edit a Post

Delete a Post

API Endpoints

Query Parameters

List Posts Query

Create Post Options

Post Data Structure

Tips & Best Practices

Related Guides