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.

The API sees the same sets you see in Pallyy: the sets your account owns, plus any set another account has shared with you through a team invite. Shared sets carry the plan limits of their owner, so a post or upload into one counts against the owner's plan, not yours.

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

List social sets

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, owned and shared alike. This list is not paginated:

{
  "items": [
    {
      "id": "665f1c2ab7e2a4d1f0a1b2c3",
      "ownedBy": "665f1c2ab7e2a4d1f0a1b2c0",
      "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 a social set

GET /v1/social-sets/{id}

Returns a single social set, or a 404 if the id does not exist, is not owned by or shared with your account, or is outside the key's restriction.

The social set object

Each entry in accounts describes one connected profile:

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