Skip to main content
GET
/
api
/
notifications
List notifications (paginated)
curl --request GET \
  --url https://app.autoposting.ai/api-proxy/api/notifications \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "notifications": [
      {
        "id": "notif_01HXYZ",
        "type": "post.published",
        "title": "Post published successfully",
        "body": "Your post on LinkedIn has been published.",
        "read": false,
        "metadata": {
          "postId": "post_01HXYZ",
          "brandSlug": "acme-corp",
          "platform": "linkedin"
        },
        "createdAt": "2024-01-10T09:05:00Z"
      },
      {
        "id": "notif_02HXYZ",
        "type": "post.failed",
        "title": "Post failed",
        "body": "Your post on X failed to publish. Click to retry.",
        "read": true,
        "metadata": {
          "postId": "post_02HXYZ",
          "platform": "x"
        },
        "createdAt": "2024-01-09T14:00:00Z"
      }
    ],
    "total": 2
  }
}

Authorizations

Authorization
string
header
required

API key as Authorization: Bearer sk-social-...

Query Parameters

limit
number
default:50

Items per page. Default: 50, max: 100.

Required range: x <= 100
offset
number
default:0

Items to skip. Default: 0.

unreadOnly
boolean

If true, returns only unread notifications.

Response

List of notifications

success
boolean
required
data
object
required