- Documentation
- API · Version 1.0
- Brands and destinations
Brands and destinations
On this page
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
}
]
}
timezoneis the default time zone for the brand's publications.pausedistruewhen 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_limitandmonthly_delivery_limitare the brand's quotas: those of the workspace's plan, unless the brand has its own.nullmeans "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 |
|---|---|---|---|---|---|---|
| 63,206 | yes | 1 | no | yes | no | |
| 2,200 | no | 1 | yes | yes | no | |
| 3,000 | yes | 1 | no | yes | no | |
| Threads | 500 | yes | 1 | no | yes | no |
| 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.