AHahrefs
Social Media

Update post

Changed on

Requests to this endpoint are free and do not consume any API units.

patch/social-media/post

Request

  • Base URL
    https://api.ahrefs.com/v3
  • URL
    https://api.ahrefs.com/v3/social-media/post
  • Auth
    HTTP bearer

Query parameters

output'json' | 'php'

The output format.

Request body

post_idinteger required

Unique identifier for the post.

channel_idsstring[]

Non-empty list of channel IDs to publish the post to.

text_contentstring

Text content of the post.

timing'publish_now' | 'scheduled' | 'draft'

When to publish the post.

scheduled_atstring date-time

Timestamp for scheduled posts (required when timing is scheduled)

auto_commentstring

Auto-comment text posted after publishing.

Example request

{
  "scheduled_at": "2026-01-01T12:00:00Z"
}

Response

OK

Changes

  • ff6f6f9eb0dcRevision changes
    • breaking

      removed the enum value csv from the query request parameter output

    • breaking

      removed the enum value xml from the query request parameter output