Notes

A note is a reminder pinned to a day on a social set's calendar. Notes are created in Pallyy, from a shared calendar, or imported from Google Calendar, and a recurring note appears once per occurrence: each occurrence is its own note with its own id.

Notes are read-only over the API.

List notes

GET /v1/notes

The range can span at most 366 days, a wider or reversed range returns a 400. Every note in the range is returned, sorted by scheduledAt ascending. This list is not paginated.

curl "https://app.pallyy.com/api/v1/notes?socialSetId=SET_ID&filters[startDate]=2026-09-01T00:00:00.000Z&filters[endDate]=2026-10-01T00:00:00.000Z" \
  -H "Authorization: Bearer pallyy_your_api_key"

Get a note

GET /v1/notes/{id}

Returns a single note, or a 404 if it does not exist or is outside the key's access.

The note object

{
  "id": "665f1c2ab7e2a4d1f0a1b2c6",
  "socialSetId": "665f1c2ab7e2a4d1f0a1b2c3",
  "type": "ONE_TIME",
  "source": { "type": "APP" },
  "content": "Product launch, prepare the stories",
  "hexColor": "#faf785",
  "scheduledAt": "2026-09-14T00:00:00.000Z",
  "createdAt": "2026-08-20T10:00:00.000Z"
}