[{"data":1,"prerenderedAt":622},["ShallowReactive",2],{"api-docs-articles":3,"api-docs-nav-articles":72,"api-docs-article-notes":85,"api-docs-related-notes":617},[4,11,17,23,28,34,40,46,52,57,62,67],{"path":5,"title":6,"description":7,"category":8,"emoji":9,"order":10},"\u002Fdocs\u002Fapi\u002Fauthentication","Authentication","Authenticate Pallyy API requests with an API key, understand scopes for reading and writing, and restrict keys to specific social sets.","getting-started","🔑",1,{"path":12,"title":13,"description":14,"category":8,"emoji":15,"order":16},"\u002Fdocs\u002Fapi\u002Ferrors","Errors","How the Pallyy API reports errors: HTTP status codes, the machine-readable error code in the response body, and validation error details.","⚠️",3,{"path":18,"title":19,"description":20,"category":21,"emoji":22,"order":10},"\u002Fdocs\u002Fapi\u002Fmcp","MCP server","Connect Claude, ChatGPT, Cursor, or any MCP client to your Pallyy account: the server URL, what the tools can do, how consent works, and how to disconnect an app.","mcp","🤖",{"path":24,"title":25,"description":26,"category":21,"emoji":27,"order":16},"\u002Fdocs\u002Fapi\u002Fmcp-authorization","MCP authorization","How MCP clients sign in to Pallyy with OAuth 2.1: discovery documents, client identification, PKCE, scopes, token lifetimes, refresh rotation, and revocation.","🔐",{"path":29,"title":30,"description":31,"category":21,"emoji":32,"order":33},"\u002Fdocs\u002Fapi\u002Fmcp-tools","MCP tools","Reference for the 15 tools the Pallyy MCP server exposes to AI assistants: social sets, post sets, media, media uploads, and calendar notes, with every input.","🧰",2,{"path":35,"title":36,"description":37,"category":38,"emoji":39,"order":16},"\u002Fdocs\u002Fapi\u002Fmedia","Media library","Browse a social set's media library via the Pallyy API, filter by folder, type, or name, and reference items when creating posts.","endpoints","🖼️",{"path":41,"title":42,"description":43,"category":38,"emoji":44,"order":45},"\u002Fdocs\u002Fapi\u002Fmedia-uploads","Media uploads","Import images and videos into a Pallyy media library from a URL via the API, poll the upload's status, and use the result in posts.","⬆️",4,{"path":47,"title":48,"description":49,"category":38,"emoji":50,"order":51},"\u002Fdocs\u002Fapi\u002Fnotes","Notes","Read and create the notes pinned to a social set's calendar via the Pallyy API: reminders, recurring notes, and events imported from Google Calendar.","📝",5,{"path":53,"title":54,"description":55,"category":8,"emoji":56,"order":45},"\u002Fdocs\u002Fapi\u002Fpagination","Pagination and queries","How Pallyy API list endpoints paginate with page and size parameters, and how to pass nested filters and sorting in the query string.","📄",{"path":58,"title":59,"description":60,"category":38,"emoji":61,"order":33},"\u002Fdocs\u002Fapi\u002Fpost-sets","Post sets","Create, schedule, list, and update Pallyy post sets via the API: one scheduled slot holding a post for each social network it targets.","🗓️",{"path":63,"title":64,"description":65,"category":8,"emoji":66,"order":33},"\u002Fdocs\u002Fapi\u002Frate-limits","Rate limits","The Pallyy API allows 5 requests per second per account. Read the rate limit headers on every response and back off on 429s.","⏱️",{"path":68,"title":69,"description":70,"category":38,"emoji":71,"order":10},"\u002Fdocs\u002Fapi\u002Fsocial-sets","Social sets","List your Pallyy social sets and their connected accounts via the API. Almost every other endpoint needs a social set id.","👥",[73,74,75,76,77,78,79,80,81,82,83,84],{"path":5,"title":6,"category":8,"order":10},{"path":12,"title":13,"category":8,"order":16},{"path":18,"title":19,"category":21,"order":10},{"path":24,"title":25,"category":21,"order":16},{"path":29,"title":30,"category":21,"order":33},{"path":35,"title":36,"category":38,"order":16},{"path":41,"title":42,"category":38,"order":45},{"path":47,"title":48,"category":38,"order":51},{"path":53,"title":54,"category":8,"order":45},{"path":58,"title":59,"category":38,"order":33},{"path":63,"title":64,"category":8,"order":33},{"path":68,"title":69,"category":38,"order":10},{"id":86,"title":48,"body":87,"category":38,"datePublished":609,"dateUpdated":610,"description":49,"emoji":50,"extension":611,"meta":612,"navigation":613,"order":51,"path":47,"seo":614,"stem":615,"__hash__":616},"apiDocs\u002Fdocs\u002Fapi\u002Fnotes.md",{"type":88,"value":89,"toc":602},"minimark",[90,94,107,112,122,182,193,201,205,211,218,222,228,237,341,363,369,373,379,387,445,451,455,463],[91,92,93],"p",{},"A note is a reminder pinned to a day on a social set's calendar. Notes are created in Pallyy, from a shared calendar, imported from Google Calendar, or created via the API, and a recurring note appears once per occurrence: each occurrence is its own note with its own id.",[91,95,96,97,101,102,106],{},"Creating or editing a note requires the ",[98,99,100],"code",{},"notes:write"," scope, see ",[103,104,105],"a",{"href":5},"authentication",".",[108,109,111],"h2",{"id":110},"list-notes","List notes",[113,114,119],"pre",{"className":115,"code":117,"language":118},[116],"language-text","GET \u002Fv1\u002Fnotes\n","text",[98,120,117],{"__ignoreMap":121},"",[123,124,125,141],"table",{},[126,127,128],"thead",{},[129,130,131,135,138],"tr",{},[132,133,134],"th",{},"Parameter",[132,136,137],{},"Required",[132,139,140],{},"Meaning",[142,143,144,158,170],"tbody",{},[129,145,146,152,155],{},[147,148,149],"td",{},[98,150,151],{},"socialSetId",[147,153,154],{},"Yes",[147,156,157],{},"The social set whose notes to list",[129,159,160,165,167],{},[147,161,162],{},[98,163,164],{},"filters[startDate]",[147,166,154],{},[147,168,169],{},"ISO 8601, notes scheduled at or after this time",[129,171,172,177,179],{},[147,173,174],{},[98,175,176],{},"filters[endDate]",[147,178,154],{},[147,180,181],{},"ISO 8601, notes scheduled before this time",[91,183,184,185,188,189,192],{},"The range can span at most 366 days, a wider or reversed range returns a ",[98,186,187],{},"400",". Every note in the range is returned, sorted by ",[98,190,191],{},"scheduledAt"," ascending. This list is not paginated.",[113,194,199],{"className":195,"code":197,"language":198,"meta":121},[196],"language-bash","curl \"https:\u002F\u002Fapp.pallyy.com\u002Fapi\u002Fv1\u002Fnotes?socialSetId=SET_ID&filters[startDate]=2026-09-01T00:00:00.000Z&filters[endDate]=2026-10-01T00:00:00.000Z\" \\\n  -H \"Authorization: Bearer pallyy_your_api_key\"\n","bash",[98,200,197],{"__ignoreMap":121},[108,202,204],{"id":203},"get-a-note","Get a note",[113,206,209],{"className":207,"code":208,"language":118},[116],"GET \u002Fv1\u002Fnotes\u002F{id}\n",[98,210,208],{"__ignoreMap":121},[91,212,213,214,217],{},"Returns a single note, or a ",[98,215,216],{},"404"," if it does not exist or is outside the key's access.",[108,219,221],{"id":220},"create-a-note","Create a note",[113,223,226],{"className":224,"code":225,"language":118},[116],"POST \u002Fv1\u002Fnotes\n",[98,227,225],{"__ignoreMap":121},[91,229,230,231,233,234,106],{},"Requires ",[98,232,100],{},". Returns the created note with a ",[98,235,236],{},"201",[123,238,239,250],{},[126,240,241],{},[129,242,243,246,248],{},[132,244,245],{},"Field",[132,247,137],{},[132,249,140],{},[142,251,252,263,275,315,326],{},[129,253,254,258,260],{},[147,255,256],{},[98,257,151],{},[147,259,154],{},[147,261,262],{},"The social set to pin the note to",[129,264,265,270,272],{},[147,266,267],{},[98,268,269],{},"content",[147,271,154],{},[147,273,274],{},"The note text, up to 1024 characters",[129,276,277,282,284],{},[147,278,279],{},[98,280,281],{},"hexColor",[147,283,154],{},[147,285,286,287,290,291,290,294,290,297,290,300,290,303,290,306,290,309,290,312],{},"The note's colour, one of ",[98,288,289],{},"#faf785",", ",[98,292,293],{},"#fff0db",[98,295,296],{},"#ffe5e5",[98,298,299],{},"#ffe4f7",[98,301,302],{},"#f2edff",[98,304,305],{},"#e1effc",[98,307,308],{},"#e4f8e2",[98,310,311],{},"#eee2d7",[98,313,314],{},"#f2f2f2",[129,316,317,321,323],{},[147,318,319],{},[98,320,191],{},[147,322,154],{},[147,324,325],{},"ISO 8601 date-time the note is pinned to",[129,327,328,333,336],{},[147,329,330],{},[98,331,332],{},"repeat",[147,334,335],{},"No",[147,337,338],{},[98,339,340],{},"{ \"interval\": \"DAY\" | \"WEEK\" | \"MONTH\" | \"YEAR\", \"occurrences\": 2-100 }",[91,342,343,344,346,347,350,351,354,355,358,359,362],{},"Omitting ",[98,345,332],{}," creates a single ",[98,348,349],{},"ONE_TIME"," note. Passing it creates a ",[98,352,353],{},"RECURRING"," series: the call returns the first occurrence, and the rest are created alongside it, each as its own note spaced by ",[98,356,357],{},"interval"," for ",[98,360,361],{},"occurrences"," total notes.",[113,364,367],{"className":365,"code":366,"language":198,"meta":121},[196],"curl -X POST https:\u002F\u002Fapp.pallyy.com\u002Fapi\u002Fv1\u002Fnotes \\\n  -H \"Authorization: Bearer pallyy_your_api_key\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"socialSetId\": \"SET_ID\",\n    \"content\": \"Product launch, prepare the stories\",\n    \"hexColor\": \"#faf785\",\n    \"scheduledAt\": \"2026-09-14T00:00:00.000Z\"\n  }'\n",[98,368,366],{"__ignoreMap":121},[108,370,372],{"id":371},"update-a-note","Update a note",[113,374,377],{"className":375,"code":376,"language":118},[116],"PATCH \u002Fv1\u002Fnotes\u002F{id}\n",[98,378,376],{"__ignoreMap":121},[91,380,230,381,383,384,386],{},[98,382,100],{},". The update is partial: omitted fields keep their saved values. For a ",[98,385,353],{}," note, the update only applies to that occurrence, the rest of the series is unaffected.",[123,388,389,397],{},[126,390,391],{},[129,392,393,395],{},[132,394,245],{},[132,396,140],{},[142,398,399,407,433],{},[129,400,401,405],{},[147,402,403],{},[98,404,269],{},[147,406,274],{},[129,408,409,413],{},[147,410,411],{},[98,412,281],{},[147,414,286,415,290,417,290,419,290,421,290,423,290,425,290,427,290,429,290,431],{},[98,416,289],{},[98,418,293],{},[98,420,296],{},[98,422,299],{},[98,424,302],{},[98,426,305],{},[98,428,308],{},[98,430,311],{},[98,432,314],{},[129,434,435,439],{},[147,436,437],{},[98,438,191],{},[147,440,441,442,444],{},"ISO 8601 date-time the note is pinned to. Can't be changed on a ",[98,443,353],{}," note or one imported from Google Calendar",[113,446,449],{"className":447,"code":448,"language":198,"meta":121},[196],"curl -X PATCH https:\u002F\u002Fapp.pallyy.com\u002Fapi\u002Fv1\u002Fnotes\u002FNOTE_ID \\\n  -H \"Authorization: Bearer pallyy_your_api_key\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"content\": \"Product launch, prepare the stories and reels\"\n  }'\n",[98,450,448],{"__ignoreMap":121},[108,452,454],{"id":453},"the-note-object","The note object",[113,456,461],{"className":457,"code":459,"language":460,"meta":121},[458],"language-json","{\n  \"id\": \"665f1c2ab7e2a4d1f0a1b2c6\",\n  \"socialSetId\": \"665f1c2ab7e2a4d1f0a1b2c3\",\n  \"type\": \"ONE_TIME\",\n  \"source\": { \"type\": \"APP\" },\n  \"content\": \"Product launch, prepare the stories\",\n  \"hexColor\": \"#faf785\",\n  \"scheduledAt\": \"2026-09-14T00:00:00.000Z\",\n  \"createdAt\": \"2026-08-20T10:00:00.000Z\"\n}\n","json",[98,462,459],{"__ignoreMap":121},[123,464,465,476],{},[126,466,467],{},[129,468,469,471,474],{},[132,470,245],{},[132,472,473],{},"Type",[132,475,140],{},[142,477,478,491,502,519,540,550,579,590],{},[129,479,480,485,488],{},[147,481,482],{},[98,483,484],{},"id",[147,486,487],{},"string",[147,489,490],{},"The note id",[129,492,493,497,499],{},[147,494,495],{},[98,496,151],{},[147,498,487],{},[147,500,501],{},"The social set the note belongs to",[129,503,504,509,511],{},[147,505,506],{},[98,507,508],{},"type",[147,510,487],{},[147,512,513,515,516,518],{},[98,514,349],{},", or ",[98,517,353],{}," for one occurrence of a repeating note",[129,520,521,526,528],{},[147,522,523],{},[98,524,525],{},"source.type",[147,527,487],{},[147,529,530,531,290,534,515,537],{},"Where the note came from: ",[98,532,533],{},"APP",[98,535,536],{},"SHARED_CALENDAR",[98,538,539],{},"GOOGLE_IMPORT",[129,541,542,546,548],{},[147,543,544],{},[98,545,269],{},[147,547,487],{},[147,549,274],{},[129,551,552,556,558],{},[147,553,554],{},[98,555,281],{},[147,557,487],{},[147,559,560,561,290,563,290,565,290,567,290,569,290,571,290,573,290,575,290,577],{},"The note's colour in Pallyy, one of ",[98,562,289],{},[98,564,293],{},[98,566,296],{},[98,568,299],{},[98,570,302],{},[98,572,305],{},[98,574,308],{},[98,576,311],{},[98,578,314],{},[129,580,581,585,587],{},[147,582,583],{},[98,584,191],{},[147,586,487],{},[147,588,589],{},"ISO 8601 time the note is pinned to",[129,591,592,597,599],{},[147,593,594],{},[98,595,596],{},"createdAt",[147,598,487],{},[147,600,601],{},"ISO 8601 time the note was created",{"title":121,"searchDepth":33,"depth":16,"links":603},[604,605,606,607,608],{"id":110,"depth":33,"text":111},{"id":203,"depth":33,"text":204},{"id":220,"depth":33,"text":221},{"id":371,"depth":33,"text":372},{"id":453,"depth":33,"text":454},"2026-08-26","2026-08-27","md",{},true,{"title":48,"description":49},"docs\u002Fapi\u002Fnotes","Ss7M4gRu9VELc96frL8pqeT2J-q3EqK4x4n9lUgDk_g",[618,619,620,621],{"path":68,"title":69,"emoji":71,"order":10},{"path":58,"title":59,"emoji":61,"order":33},{"path":35,"title":36,"emoji":39,"order":16},{"path":41,"title":42,"emoji":44,"order":45},1789468948833]