---
title: "Notes"
description: "Read the notes pinned to a social set's calendar via the Pallyy API: reminders, recurring notes, and events imported from Google Calendar."
category: "endpoints"
emoji: "📝"
order: 5
datePublished: "2026-08-26"
dateUpdated: "2026-08-26"
---

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
```

| Parameter | Required | Meaning |
| --- | --- | --- |
| `socialSetId` | Yes | The social set whose notes to list |
| `filters[startDate]` | Yes | ISO 8601, notes scheduled at or after this time |
| `filters[endDate]` | Yes | ISO 8601, notes scheduled before this time |

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.

```bash
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

```json
{
  "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"
}
```

| Field | Type | Meaning |
| --- | --- | --- |
| `id` | string | The note id |
| `socialSetId` | string | The social set the note belongs to |
| `type` | string | `ONE_TIME`, or `RECURRING` for one occurrence of a repeating note |
| `source.type` | string | Where the note came from: `APP`, `SHARED_CALENDAR`, or `GOOGLE_IMPORT` |
| `content` | string | The note text, up to 1000 characters |
| `hexColor` | string | The note's colour in Pallyy, one of `#faf785`, `#fff0db`, `#ffe5e5`, `#ffe4f7`, `#f2edff`, `#e1effc`, `#e4f8e2`, `#eee2d7`, `#f2f2f2` |
| `scheduledAt` | string | ISO 8601 time the note is pinned to |
| `createdAt` | string | ISO 8601 time the note was created |