Social sets

A social set groups the social accounts you manage together, one set per brand or client. Post sets and media always belong to a social set, so listing your sets is usually the first call you make: almost every other endpoint takes a socialSetId.

Social sets are read-only over the API. If your key is restricted to specific social sets, only those sets are visible.

GET /v1/social-sets

curl https://app.pallyy.com/api/v1/social-sets \
  -H "Authorization: Bearer pallyy_your_api_key"

Returns every social set the key can access. This list is not paginated:

{
  "items": [
    {
      "id": "665f1c2ab7e2a4d1f0a1b2c3",
      "name": "My Brand",
      "timezone": "Europe/Rome",
      "defaultPostTime": "09:30",
      "thumbnailUrl": "https://...",
      "accounts": [
        {
          "id": "665f1c2ab7e2a4d1f0a1b2c4",
          "type": "INSTAGRAM",
          "name": "My Brand",
          "handle": "mybrand",
          "thumbnailUrl": "https://...",
          "accessToken": { "hasError": false }
        }
      ],
      "createdAt": "2026-01-12T09:00:00.000Z",
      "updatedAt": "2026-08-01T10:00:00.000Z"
    }
  ]
}

GET /v1/social-sets/{id}

Returns a single social set, or a 404 if the id does not exist or is outside the key's restriction.

Field	Type	Meaning
`id`	string	The social set id, used as `socialSetId` everywhere else
`name`	string	Display name
`timezone`	string	IANA timezone the set schedules in, if configured
`defaultPostTime`	string	Default posting time as `HH:mm`, if configured
`thumbnailUrl`	string	Avatar shown in Pallyy, if set
`accounts`	array	The connected social accounts
`createdAt`	string	ISO 8601 creation time
`updatedAt`	string	ISO 8601 last update time

Each entry in accounts describes one connected profile:

Field	Type	Meaning
`id`	string	The account id within Pallyy
`type`	string	One of `INSTAGRAM`, `FACEBOOK`, `TWITTER`, `LINKEDIN_PERSONAL`, `LINKEDIN_PAGE`, `GMB`, `PINTEREST`, `TIKTOK`, `YOUTUBE`, `THREADS`, `BLUESKY`
`name`	string	Profile display name
`handle`	string	Profile handle or username
`thumbnailUrl`	string	Profile picture
`accessToken.hasError`	boolean	`true` when the connection has expired and needs to be reauthorized in Pallyy

The type values are the same accountType values you target when creating post sets.

View as markdown

More in Endpoints

Questions about the API? Email us at hey@pallyy.com and we'll get back to you.

List social sets

Get a social set

The social set object

More in Endpoints