Skip to content
Quiet Social

Brands and destinations

This documentation is translated from French. Should the two versions differ, the French version prevails.

A brand is what you publish for: a company, a client, a product. A destination is a specific account on which a brand publishes: a Facebook Page, an Instagram professional account, a LinkedIn Page, a Threads account or a Pinterest board.

Connections to the networks and attaching destinations to a brand are done in the dashboard (see the guide). The API reads them; it does not create them.

GET /brands

The brands the client can see, sorted by name. A client attached to a brand sees only one.

Required scope: brands:read.

curl https://quietsocial.dev/api/v1/brands \
  -u "$QUIET_CLIENT_ID:$QUIET_CLIENT_SECRET"
{
  "data": [
    {
      "id": "brd_01k4b8x2q9r7f3m5t6v8w0y2z4",
      "name": "Fabrique du Nord",
      "timezone": "Europe/Paris",
      "locale": "fr",
      "status": "active",
      "paused": false,
      "monthly_publication_limit": 1000,
      "monthly_delivery_limit": 5000
    }
  ]
}
  • timezone is the default time zone for the brand's publications.
  • paused is true when an administrator has paused the brand's sending: a publication created or scheduled during the pause is accepted, but only goes out once sending resumes.
  • monthly_publication_limit and monthly_delivery_limit are the brand's quotas: those of the workspace's plan, unless the brand has its own. null means "no limit".
  • The list is not paginated.

Codes: 200, 401, 403, 429.

GET /destinations

The destinations visible to the client, sorted by name.

Required scope: destinations:read.

Parameter Type Default Note
brand_id brd_… Returns only the destinations of this brand. A brand out of scope returns an empty list.
per_page integer 25 Between 1 and 100.
page integer 1
curl "https://quietsocial.dev/api/v1/destinations?per_page=50" \
  -u "$QUIET_CLIENT_ID:$QUIET_CLIENT_SECRET"
{
  "data": [
    {
      "id": "dst_01k4b8x2q9r7f3m5t6v8w0y2z4",
      "brand_id": "brd_01k4b8x2q9r7f3m5t6v8w0y2z4",
      "network": "facebook",
      "name": "Fabrique du Nord",
      "username": "fabriquedunord",
      "avatar_url": "https://scontent.example/avatar.jpg",
      "status": "active",
      "can_publish": true,
      "capabilities": {
        "text": true,
        "link": true,
        "image": true,
        "maximum_text_length": 63206,
        "maximum_media_count": 1,
        "requires_media": false,
        "alt_text": true,
        "first_comment": false,
        "title": false
      },
      "synchronized_at": "2026-09-30T04:40:12+00:00"
    }
  ],
  "links": { "first": "…", "last": "…", "prev": null, "next": null },
  "meta": { "current_page": 1, "from": 1, "last_page": 1, "path": "…", "per_page": 50, "to": 1, "total": 1, "links": ["…"] }
}

Pagination is described in Limits and conventions.

Codes: 200, 401, 403, 429.

GET /destinations/{id}

Required scope: destinations:read.

The response is the same object, wrapped in data. A destination of another brand responds 404.

Codes: 200, 401, 403, 404, 429.

Reading a destination

network

The short name of the network. It is the value that overrides expects when creating a publication, and the one returned by a publication's targets.

network Destination
facebook Facebook Page
instagram Instagram professional account
linkedin LinkedIn Page
threads Threads account
pinterest Pinterest board

status and can_publish

status is active, disabled (disabled by a team member) or unavailable (the network no longer provides it, or the connection was revoked).

can_publish is true only if the destination is active, its own token has not expired and the connection that carries it is active. An active Page attached to a revoked connection cannot be published to. A publication to a destination whose can_publish is false is refused at creation.

capabilities

What the destination accepts, so you can compose without being refused:

Field Meaning
text Accepts text.
link Accepts a link (link_url).
image Accepts an image.
maximum_text_length Maximum text length, in characters.
maximum_media_count Maximum number of images.
requires_media An image is required.
alt_text An image's alt text is passed on to the network.
first_comment A first comment can be published under the post. False everywhere today.
title The post carries a visible title, separate from the text (a Pin's title).

Capabilities are recomputed on every synchronization of the destination: read them rather than copying them. Current values:

Network Max. text Link Max. images Image required Alt text Title
Facebook 63,206 yes 1 no yes no
Instagram 2,200 no 1 yes yes no
LinkedIn 3,000 yes 1 no yes no
Threads 500 yes 1 no yes no
Pinterest 800 yes 1 yes yes yes

Text length is counted the way the network counts it: added hashtags included (except on Threads), after escaping reserved characters on LinkedIn, and on Threads each emoji counts for its number of UTF-8 bytes (😀 counts for 4).

Each network also imposes its own rules on the image itself; they are checked before sending and detailed in the guide.